POST /v1/marketing/campaigns
MarketingService_CreateCampaign
The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.
Parameters
No path or query parameters.
Request body
amountstringasset_codestringbenefit_expires_after_secondsstringbenefit_typestringbudget_amountstringcapability_idstringcodestringcoupon_definition_idstringdescriptionstringeligible_api_key_idstringends_atstringenvironment_idstringmax_grantsstringmax_grants_per_customerstringmeter_codestringnamestringoffer_idstringproduct_idstringstarts_atstringtrigger_typestring
cURL
curl --request POST 'https://nexus-api.rainlib.com/v1/marketing/campaigns' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"amount": "<value>",
"asset_code": "<value>",
"benefit_expires_after_seconds": "<value>",
"benefit_type": "<value>",
"budget_amount": "<value>",
"capability_id": "<value>",
"code": "<value>",
"coupon_definition_id": "<value>",
"description": "<value>",
"eligible_api_key_id": "<value>",
"ends_at": "<value>",
"environment_id": "<value>",
"max_grants": "<value>",
"max_grants_per_customer": "<value>",
"meter_code": "<value>",
"name": "<value>",
"offer_id": "<value>",
"product_id": "<value>",
"starts_at": "<value>",
"trigger_type": "<value>"
}'Response contract
200 · OK
affected_revisionobjectExpand fields
amountstringapproved_atstringasset_codestringbenefit_expires_after_secondsstringbenefit_typestringbudget_amountstringcapability_idstringcoupon_definition_idstringcreated_atstringeligible_api_key_idstringends_atstringenvironment_idstringidstringmax_grantsstringmax_grants_per_customerstringmeter_codestringoffer_idstringproduct_idstringpublished_atstringrevision_nointeger · int32starts_atstringstatusstringtrigger_typestringversionstring
codestringcreated_atstringcurrent_revisionobjectExpand fields
amountstringapproved_atstringasset_codestringbenefit_expires_after_secondsstringbenefit_typestringbudget_amountstringcapability_idstringcoupon_definition_idstringcreated_atstringeligible_api_key_idstringends_atstringenvironment_idstringidstringmax_grantsstringmax_grants_per_customerstringmeter_codestringoffer_idstringproduct_idstringpublished_atstringrevision_nointeger · int32starts_atstringstatusstringtrigger_typestringversionstring
current_revision_idstringdescriptionstringidstringnamestringstatsobjectServer-derived runtime projection for the current published revision. A missing remaining field means that cap is unlimited; it never means zero.
Expand fields
budget_remainingstringgrant_slots_remainingstringgranted_amountstringgranted_countstringrevoked_countstring
statusstringupdated_atstringversionstring
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.