POST
/
v1
/
merchant
/
callbacks
Set Callback URLs
curl --request POST \
  --url https://api.bolt.com/v1/merchant/callbacks \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "callback_urls": [
    {
      "type": "oauth_redirect",
      "url": "https://example.com/1"
    },
    {
      "type": "oauth_logout",
      "url": "https://example.com/2"
    },
    {
      "type": "get_account",
      "url": "https://example.com/3"
    }
  ],
  "division_id": "3X9aPQ67-YrB"
}
'
{
  "errors": [
    {
      "code": 2001005,
      "message": "The input is missing a required parameter."
    }
  ],
  "result": {
    "success": false
  }
}

Authorizations

​
X-API-Key
string
header
required

Admins and Developers can obtain their Bolt API key from the Bolt Merchant Dashboard.

Body

application/json
​
callback_urls
object[]
required

List of callback URLs to configure

Example:
[
  {
    "type": "oauth_redirect",
    "url": "https://example.com/1"
  },
  {
    "type": "oauth_logout",
    "url": "https://example.com/2"
  },
  {
    "type": "get_account",
    "url": "https://example.com/3"
  }
]
​
division_id
string
required

The unique ID associated to the merchant's Bolt Account division; Merchants can have different divisions to suit multiple use cases (storefronts, pay-by-link, phone order processing). Use the Bolt Merchant Dashboard to switch between divisions and find the division ID under Merchant Division Public ID.

Example:

"3X9aPQ67-YrB"

Response

Successfully sets callback URLs. No JSON schema is expected.