Skip to main content
POST
/
organizations
/
me
/
{org_id}
/
applications
Create Application
curl --request POST \
  --url https://apx.didit.me/auth/v2/organizations/me/{org_id}/applications/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Customer App",
  "website_url": "https://acme.example",
  "redirect_uris": [
    "https://acme.example/callback"
  ],
  "terms_url": "https://acme.example/terms",
  "privacy_url": "https://acme.example/privacy"
}
'
{
  "uuid": "b2c3d4e5-6789-01bc-defg-222222222222",
  "name": "Acme Customer App",
  "client_id": "S9LIYGSoWNuGMLHsvEt9dQ",
  "api_key": "05mHcOWL8GathLZlz8oIDawYj9qFAcoSHtz-75PAkuo",
  "website_url": "https://acme.example",
  "redirect_uris": [
    "https://acme.example/callback"
  ],
  "terms_url": "https://acme.example/terms",
  "privacy_url": "https://acme.example/privacy",
  "description": null,
  "created_at": "2025-06-01T10:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.didit.me/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint when you need to separate verification traffic, credentials, branding, or reporting inside the same organization. This is especially useful for resellers that create one application per customer. It also works well when your own company has multiple products, brands, regions, staging/production environments, or use cases that should not share the same API key and application-level settings.
All Auth API endpoints use https://apx.didit.me/auth/v2. Use the returned api_key as x-api-key when calling https://verification.didit.me/v3/... endpoints such as sessions and workflows.

Authorizations

​
Authorization
string
header
required

Access token from login or verify-email response

Path Parameters

​
org_id
string<uuid>
required

Body

application/json
​
name
string

Application display name. Defaults to the organization name plus App.

​
website_url
string

Website or app URL associated with this application.

​
redirect_uris
string[]

Allowed redirect URIs for OAuth-style flows.

​
terms_url
string

Terms of service URL shown for this application.

​
privacy_url
string

Privacy policy URL shown for this application.

​
description
string

Internal description for the application.

Response

Application created. Store the api_key securely and use it as x-api-key for verification.didit.me /v3 calls.

​
uuid
string<uuid>
​
name
string
​
client_id
string
​
api_key
string

Your API key. Use as the x-api-key header for Didit verification API calls on https://verification.didit.me/v3. This is the same value as client_secret.

​
website_url
string | null
​
redirect_uris
string[]
​
terms_url
string
​
privacy_url
string
​
description
string | null
​
created_at
string<date-time>