Register a redirect URL
POST /rest/v1/redirect_urls
An absolute https:// URL without query string or fragment (any query is allowed on return), on a public host: localhost, *.localhost, *.local, *.internal, names without a dot and loopback, private, link-local (incl. 169.254.169.254) or unspecified IP addresses answer 422 validation_failed (param: url). A return_url matches when it has the same origin and its path starts with the registered path. Up to 20 per store; registering an existing URL returns it. Requires channels:connect.
Authorization
apiKey Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/redirect_urls" \ -H "Content-Type: application/json" \ -d '{ "url": "https://app.example.com/nembol/callback" }'{ "id": "rdu_66f0a1", "object": "redirect_url", "url": "http://example.com", "created_at": "2019-08-24T14:15:22Z", "inherited": true}Last updated on October 18, 2026
Need help?
Email us and a human replies, usually within one business day.