---
title: "Set Callback URLs"
method: POST
path: "/v1/merchant/callbacks"
tags: ["Configuration"]
---

# Set Callback URLs

`POST /v1/merchant/callbacks`

Configure callbacks URLs for a Bolt merchant division. This will store or override only the callback URLs that are specified in the request. Operations are fully transactional.

## Request body

- MerchantCallbacksInput
  - `callback_urls` object[], required — List of callback URLs to configure
    - `type` 'oauth_redirect' | 'oauth_logout' | 'get_account' | 'create_order' | 'universal_merchant_api' | 'shipping' | 'tax' | 'update_cart' | 'debug' | 'remote_api' | 'product_info' | 'support_page' | 'account_page' | 'mobile_app_domain' | 'validate_additional_account_data' | 'terms_of_service' | 'privacy_policy' | 'base_domain' | 'confirmation_redirect', required — Bolt merchant division callback URL type
    - `url` string, required — The full callback URL.
  - `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`.

## Response `200`

Successfully sets callback URLs. No JSON schema is expected.

## Other responses

- `400` — BAD REQUEST. Request is malformed or invalid value types are detected. division_id could be invalid.
- `403` — Invalid Merchant API Key
- `422` — Request did not pass input validation. Check required fields are populated & meet input requirements.

---

[API](https://skmtc.dev/bolt/apis/bolt-api-reference.md) · [All operations](https://skmtc.dev/bolt/apis/bolt-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bolt/bolt-api-reference/revisions/1f62c40558c6/schema)