Skip to main content
POST
/
plaid
/
callback
/
{plaid_link_token}
Submit Plaid public token
curl --request POST \
  --url https://api.lightspark.com/grid/2025-10-13/plaid/callback/{plaid_link_token} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "publicToken": "public-sandbox-12345678-1234-1234-1234-123456789012",
  "accountId": "plaid_account_id_123"
}'
{
  "message": "External account creation initiated. You will receive a webhook notification when complete.",
  "requestId": "req_abc123def456"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
plaid_link_token
string
required

The Plaid link token from the link token response, used to identify the session

Body

application/json
​
publicToken
string
required

The public token returned by Plaid Link after the customer successfully authenticates and selects an account.

Example:

"public-sandbox-12345678-1234-1234-1234-123456789012"

​
accountId
string

Optional Plaid account ID if the customer selected a specific account. If not provided, the default account will be used.

Example:

"plaid_account_id_123"

Response

Public token accepted and external account creation initiated. The platform will receive a webhook notification when the external account is ready.

​
message
string
required

Human-readable message about the processing status

Example:

"External account creation initiated. You will receive a webhook notification when complete."

​
requestId
string

A unique identifier for this request, useful for debugging

Example:

"req_abc123def456"

⌘I