Link a stablecoin provider account

Link provider API credentials for the authenticated platform. Provider credentials are account-scoped and can be reused for multiple stablecoins. Currently, the only supported provider is BRALE; the provider environment is derived from the authenticated Grid platform mode.

POST /stablecoin-provider-accounts

Link a stablecoin provider account

cURL

curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/stablecoin-provider-accounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "provider": "BRALE",
  "apiClientId": "provider_client_123",
  "apiClientSecret": "provider_secret_456",
  "providerAccountId": "2VcUIonJeVQzFoBuC7LdFT0dRe4"
}
'

201

{
  "id": "StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001",
  "provider": "BRALE",
  "providerAccountId": "2VcUIonJeVQzFoBuC7LdFT0dRe4",
  "providerEnvironment": "SANDBOX",
  "status": "ACTIVE",
  "createdAt": "2026-05-20T16:35:00Z",
  "updatedAt": "2026-05-20T16:35:00Z",
  "lastVerifiedAt": "2026-05-20T16:35:00Z"
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Headers

Idempotency-Key · string · required

Idempotency key for retrying this request safely. Replays return the prior result; conflicting payloads are rejected.

Maximum string length: 255

Body

application/json

provider · enum<string> · required

Stablecoin provider backing the linked account, stablecoin, or operation.

Available options: BRALE

apiClientId · string · required

Provider API client id used to verify and link the provider account.

Example:

"provider_client_123"

apiClientSecret · string · required · write-only

Provider API client secret. Grid verifies and stores this secret encrypted; it is never returned.

Example:

"provider_secret_456"

providerAccountId · string

Provider account id. Optional when the submitted credentials expose exactly one provider account.

Example:

"2VcUIonJeVQzFoBuC7LdFT0dRe4"

Response

201

application/json

Stablecoin provider account linked

id · string · required

System-generated stablecoin provider account link identifier.

Example:

"StablecoinProviderAccount:019542f5-b3e7-1d02-0000-000000000001"

provider · enum<string> · required

Stablecoin provider backing the linked account, stablecoin, or operation.

Available options: BRALE

providerAccountId · string · required

Provider account id.

Example:

"2VcUIonJeVQzFoBuC7LdFT0dRe4"

providerEnvironment · enum<string> · required

Provider environment derived from the authenticated Grid platform mode.

Available options: SANDBOX, PRODUCTION

status · enum<string> · required

Status of the linked stablecoin provider account credentials.

Available options: ACTIVE, INVALID, REVOKED

createdAt · string<date-time> · required

Creation timestamp.

Example:

"2026-05-20T16:35:00Z"

updatedAt · string<date-time> · required

Last update timestamp.

Example:

"2026-05-20T16:35:00Z"

lastVerifiedAt · string<date-time>

Timestamp of the last successful provider credential verification.

Example:

"2026-05-20T16:35:00Z"