{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"type":"markdown"},"seo":{"title":"Registering Callbacks","description":"We’re on a mission to help brands exceed customer expectations and grow profitably. We’re excited to work with you. Let’s do this!"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"registering-callbacks","__idx":0},"children":["Registering Callbacks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Register your callback base URL to receive events from Onward. A list of events you'll receive is available in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/callbacks"},"children":["apis/callbacks"]},"."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your Onward dashboard, go to Account > Onward API"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the base URL where your API will receive events in the \"Callback endpoint base URL\" field"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click Save"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/register-callback-url.32a67fcc0e6b347010533139a1b3db7ff2026aef194ff1500285e56a4cf9eb17.9bb1daa4.png","alt":"Onward API / Register Callback URL","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication","__idx":1},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Onward authenticates API requests to your endpoint by including your API key in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-Key"]}," header. You should validate that this header matches the key shown in your account settings."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keep your API key secure and validate it on all incoming requests to ensure they are legitimate calls from Onward."]}]}]},"headings":[{"value":"Registering Callbacks","id":"registering-callbacks","depth":1},{"value":"Authentication","id":"authentication","depth":3}],"frontmatter":{"seo":{"title":"Registering Callbacks"}},"lastModified":"2026-10-22T16:34:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/registering_callbacks","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}