Create Talon.One campaigns from a template and generate coupons via the Management API
domain: docs.talon.one · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Create a Management API key scoped to the target Application (and, optionally, to specific endpoints) in Campaign Manager, or obtain a session bearer token as an alternative auth path.
Call the Management API's create-campaign-from-template operation to spin up a new campaign under an Application, verifying the exact create-campaign path for your account/API version against the live Management API reference.
Define any custom attributes needed on the Coupon entity via the Attributes endpoint before generating coupons that use them.
POST to the campaign's coupons endpoint under /v1/applications/{applicationId}/campaigns/{campaignId}/coupons with a couponPattern, numberOfCoupons, and usageLimit to generate a batch of coupons.
For very large batches, use the async bulk coupon-creation path instead of the synchronous endpoint.
Build a rule in the campaign referencing coupon/profile attributes, then activate the campaign.
Known gotchas
Management API keys and Integration API keys are separate credential types created in different places — they are not interchangeable.
The Management API is meant for backoffice/admin operations; don't call it from your high-frequency checkout hot path.
Disabling or deleting the Campaign Manager user who created a Management API key invalidates that key.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?