{"Status":true,"Message":"","Response":{"post":{"postuid":"30b21ccc-1ad2-4602-b372-b4715eb45dbe","tenantuid":"d8b744fc-2e70-4089-bb80-dd1d08f6c7b2","projectuid":"542e5f51-33cf-401f-aebe-4324ebe36fe4","title":"Create or Update a Campaign","slug":"reference/campaign-1","html":"\u003Cp\u003ECreates a new campaign, or updates an existing campaign when \u003Ccode\u003EcampaignId\u003C/code\u003E is provided. When the posted \u003Ccode\u003Estatus\u003C/code\u003E differs from the stored status, the campaign transitions to the new status (for example, Active \u2192 Paused). See the \u003Ca href=\u0022/reference/campaign-object\u0022\u003Ecampaign\u003C/a\u003E object reference for field descriptions.\u003C/p\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Request Examples\u003C/div\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022d-flex header\u0022\u003E\u003Cspan\u003ECreate a new campaign\u003C/span\u003E\u003C/div\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;name\u0026quot;: \u0026quot;Spring Sale 2025 Launch\u0026quot;,\r\n  \u0026quot;description\u0026quot;: \u0026quot;Don\u2019t Miss Our Exclusive Spring Sale!\u0026quot;,\r\n  \u0026quot;campaignType\u0026quot;: \u0026quot;Conversion\u0026quot;,\r\n  \u0026quot;status\u0026quot;: \u0026quot;Active\u0026quot;,\r\n  \u0026quot;allow_autopause\u0026quot;: true,\r\n  \u0026quot;workflowBehavior\u0026quot;: \u0026quot;All\u0026quot;,\r\n  \u0026quot;isNotifyNewLead\u0026quot;: false,\r\n  \u0026quot;conversionGoals\u0026quot;: {\r\n    \u0026quot;enabled\u0026quot;: false,\r\n    \u0026quot;suspects\u0026quot;: 0,\r\n    \u0026quot;mcls\u0026quot;: 0,\r\n    \u0026quot;mqls\u0026quot;: 0,\r\n    \u0026quot;sqls\u0026quot;: 0\r\n  }\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022d-flex header\u0022\u003E\u003Cspan\u003EUpdate an existing campaign (transition to Paused)\u003C/span\u003E\u003C/div\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;campaignId\u0026quot;: 24109,\r\n  \u0026quot;name\u0026quot;: \u0026quot;Spring Sale 2025 Launch\u0026quot;,\r\n  \u0026quot;status\u0026quot;: \u0026quot;Paused\u0026quot;\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Request Parameters\u003C/div\u003E\u003Csection class=\u0022api_parameters\u0022\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003EcampaignId\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Enumber\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EId of the campaign to update. Omit when creating a new campaign.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Ename\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EDisplay name of the campaign. Required when creating.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Edescription\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EFree-form description shown in the campaign list.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003EcampaignType\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003ECampaign type. One of: Conversion, Transactional, Nurture, Broadcast.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Estatus\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003ECampaign status. One of: Active, Paused, Archived, Deleted. When this differs from the stored status, the campaign is transitioned.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003EutmCampaign\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EUTM campaign value appended to outbound tracking links. Auto-derived from name if omitted.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Esegments\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Earray\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EArray of segment ids associated with the campaign.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Esubscriber_preferences\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Earray\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EArray of subscription preference ids that contacts in this campaign can opt into/out of independently.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Eallow_autopause\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Eboolean\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EWhen true, the campaign auto-pauses after extended inactivity.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003EworkflowBehavior\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EHow this campaign interacts with automations. One of: All, Match, None.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Ecost, costPeriod\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Enumber, string\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EOptional cost tracking. costPeriod is one of None, OneTime, Daily, Weekly, Monthly, Yearly.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003EisNotifyNewLead\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Eboolean\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EWhen true, emails in notificationRecipients receive a notification for each new lead.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003EnotificationRecipients\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Earray\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EArray of user ids (as strings) that receive new-lead notifications when isNotifyNewLead is true.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003EisAutoQualifyNewLead\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Eboolean\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EWhen true, new leads are auto-promoted to Qualified status on entry.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003EconversionGoals\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Eobject\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EFunnel goals object with fields enabled, suspects, mcls, mqls, sqls. Used by the campaign funnel report.\u003C/div\u003E\u003C/section\u003E\u003C/section\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Response Examples\u003C/div\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022d-flex header\u0022\u003E\u003Cspan class=\u0022httpstatus\u0022\u003E\u003Cspan class=\u0022solid-circle success\u0022\u003E\u003C/span\u003E200\u003C/span\u003E\u003C/div\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;Status\u0026quot;: true,\r\n  \u0026quot;Message\u0026quot;: \u0026quot;\u0026quot;,\r\n  \u0026quot;Response\u0026quot;: {\r\n    \u0026quot;id\u0026quot;: 24109\r\n  }\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Response Parameters\u003C/div\u003E\u003Csection class=\u0022api_parameters\u0022\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Eid\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Enumber\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EThe id of the campaign that was created or updated.\u003C/div\u003E\u003C/section\u003E\u003C/section\u003E\u003Cp\u003E\u003C/p\u003E","json_meta":{"api_verb":"POST","api_path":"https://us-1.dailystory.com/api/v1/campaign"},"publish_status":0,"post_type":"API","authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d","author":{"authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d"},"featured_image_updating":false,"meta_description":"Learn how to create or update a campaign with example HTTP requests and JSON payloads for automated follow-up promotions.","display_toc":true,"has_workingcopy":false,"allow_indexing":true,"sort_order":7,"total_views":1,"date_published":"2026-04-18T12:00:00","date_updated":"2026-04-18T17:56:16.623","date_created":"2025-09-23T16:49:30.49"}}}