Skip to main content
POST
/
customers
Create customer
curl --request POST \
  --url https://app.gnosisramp.com/api/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "subject_token": "<string>"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "organizationId": "org_123456",
  "projectId": "proj_123456",
  "metadata": {},
  "accessToken": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.ramp.gnosis.io/llms.txt

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

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials flow for API authentication

Headers

​
Idempotency-Key
string

Optional unique key for exactly-once processing. When provided, the server guarantees that the request is processed at most once. Duplicate requests with the same key and body return the original cached response with the X-Idempotency-Replayed: true header. Using the same key with a different body returns 422. Keys are scoped per project and cached for 24 hours.

Maximum string length: 256

Body

application/json
​
id
string
required

Customer identifier

​
subject_token
string

Optional OIDC token for token exchange

Response

Customer created successfully

Customer entity

​
id
string<uuid>
required

Unique customer identifier

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
createdAt
string<date-time>
required

Customer creation timestamp

Example:

"2024-01-01T00:00:00.000Z"

​
updatedAt
string<date-time>
required

Customer last update timestamp

Example:

"2024-01-01T00:00:00.000Z"

​
organizationId
string
required

Organization identifier

Example:

"org_123456"

​
projectId
string
required

Project identifier

Example:

"proj_123456"

​
metadata
object

Additional customer metadata

​
accessToken
string | null