SupportLog in
DocsAPI ReferenceSDK ReferenceResourcesPayments ManagementChangelog

Assign a CLABE to a user

Gives each end user their own SPEI CLABE: one call per user, idempotent on `user_id`, and every transfer it receives is credited to your merchant account.

POST
/api/v1/clabe-assignments

Authorization

Authorization
Authorization<token>

Your public API key, with the word Token and a space in front of it. Example: Token 6534bc0a7e1f4d2b9c8e3a5f7b1d2c4e6f8a9b0c — that whole value is the header. Sending the key alone returns 401 'Authentication credentials were not provided'. In this playground you may paste just the key; the prefix is added for you.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/clabe-assignments" \  -H "Content-Type: application/json" \  -d '{    "user_id": "customer-48213"  }'
{
  "assignment_id": "9b2f6c1e-4d3a-4f7b-8a51-2c6e0d9f7a14",
  "clabe": "710969000012345678",
  "merchant_id": "1234",
  "user_id": "customer-48213",
  "provider_type": "Tonder",
  "assigned_at": "2026-10-13T18:22:05.123456+00:00",
  "is_new": false
}
{
  "assignment_id": "9b2f6c1e-4d3a-4f7b-8a51-2c6e0d9f7a14",
  "clabe": "710969000012345678",
  "merchant_id": "1234",
  "user_id": "customer-48213",
  "provider_type": "Tonder",
  "assigned_at": "2026-10-13T18:22:05.123456+00:00",
  "is_new": true
}
{
  "error": "INVALID_PARAMETER",
  "message": "user_id is required"
}
{
  "message": "Unauthorized"
}
{
  "message": "User is not authorized to access this resource"
}
{
  "error": "INTERNAL_ERROR",
  "message": "Unexpected error"
}
Was this page helpful?