Create customer

Create a new customer or retrieve an existing one using OIDC token exchange.

This endpoint validates an OIDC token and creates a customer record if one doesn’t exist for the authenticated user. If a customer already exists for the token’s user identifier, it returns the existing customer.

POST /customers/token-exchange

Create customer

cURL

curl --request POST \
  --url https://app.gnosisramp.com/api/v1/customers/token-exchange \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."
}
'

201

{
  "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": {},
  "access_token": "<string>"
}

Authorizations

Authorization · string · header · required

OAuth2 client credentials flow for API authentication

Body

application/json

Request body for customer token exchange

subject_token · string · required

OIDC token to exchange for customer authentication

Example:

"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."

Response

201

application/json

Customer created or retrieved 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

access_token · string | null

uRamp JWT token for authenticated customer requests