Skip to main content

Campaigns API Reference

Version
29Next Campaigns API Logo

Campaigns API

Overview
Endpoints
campaigns
carts
orders
powered by Stoplight

Campaigns API

v1
API Base URL
Live Server:https://campaigns.apps.29next.com
Security
API Key

Campaign token based authentication.

An API key is a token that you provide when making API calls. Include the token in a header parameter called Authorization.

Example: Authorization: 123

Campaigns API is a headless API for developers to easily create complex external checkout flows using javascript, no backend server-side integration required.

Before using the Campaigns API, you'll need to install the Campaigns App on your store and create a campaign to retrieve your API Key.

Campaigns API uses unique API Keys for authentication to access campaign details and execute the checkout flow with your configured packages.

Campaign APIs are rate-limited to maintain the stability for all users. We employ a number of methods to enforce rate limits including API Keys and IP Address.

IdentifierRate Limit MethodLimit
IP AddressRequest-based4 requests/second

The following sample shows the API response for the status code 429.

HTTP/1.1 429 Too Many Requests
Retry-After: 1

Rate limiting is required to prevent the network and application services from becoming overloaded.

Setting a rate limit helps to prevent API abuse and provide overall fairness of use across the platform.