Update a campaign
curl --request PATCH \
--url https://api.launchpoint.sh/2026-07/campaigns/{campaign_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"visibility": "public",
"invite_code": "<string>",
"description": "<string>",
"instructions": "<string>",
"icon_url": "<string>",
"brief_url": "<string>",
"video_examples": [
"<string>"
],
"links": [
{
"url": "https://acme.com/products/glow-serum",
"service": "shopify",
"description": "Product page to link in bio",
"affiliate_code": "CREATOR20"
}
],
"targeting": {
"groups": [
{
"conditions": [
{
"property": "877972f8-af4b-4918-95df-d35377234817",
"values": [
"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a"
]
}
],
"name": "North America"
}
]
},
"content_deadline_date": "2023-12-25",
"post_deadline_date": "2023-12-25",
"settings": {
"creator_approval_required": true,
"brand_approval_required": false,
"post_approval_mode": "strict",
"completion_mode": "all_optional"
}
}
'import requests
url = "https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}"
payload = {
"name": "<string>",
"visibility": "public",
"invite_code": "<string>",
"description": "<string>",
"instructions": "<string>",
"icon_url": "<string>",
"brief_url": "<string>",
"video_examples": ["<string>"],
"links": [
{
"url": "https://acme.com/products/glow-serum",
"service": "shopify",
"description": "Product page to link in bio",
"affiliate_code": "CREATOR20"
}
],
"targeting": { "groups": [
{
"conditions": [
{
"property": "877972f8-af4b-4918-95df-d35377234817",
"values": ["9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a"]
}
],
"name": "North America"
}
] },
"content_deadline_date": "2023-12-25",
"post_deadline_date": "2023-12-25",
"settings": {
"creator_approval_required": True,
"brand_approval_required": False,
"post_approval_mode": "strict",
"completion_mode": "all_optional"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
visibility: 'public',
invite_code: '<string>',
description: '<string>',
instructions: '<string>',
icon_url: '<string>',
brief_url: '<string>',
video_examples: ['<string>'],
links: [
{
url: 'https://acme.com/products/glow-serum',
service: 'shopify',
description: 'Product page to link in bio',
affiliate_code: 'CREATOR20'
}
],
targeting: {
groups: [
{
conditions: [
{
property: '877972f8-af4b-4918-95df-d35377234817',
values: ['9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a']
}
],
name: 'North America'
}
]
},
content_deadline_date: '2023-12-25',
post_deadline_date: '2023-12-25',
settings: {
creator_approval_required: true,
brand_approval_required: false,
post_approval_mode: 'strict',
completion_mode: 'all_optional'
}
})
};
fetch('https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'visibility' => 'public',
'invite_code' => '<string>',
'description' => '<string>',
'instructions' => '<string>',
'icon_url' => '<string>',
'brief_url' => '<string>',
'video_examples' => [
'<string>'
],
'links' => [
[
'url' => 'https://acme.com/products/glow-serum',
'service' => 'shopify',
'description' => 'Product page to link in bio',
'affiliate_code' => 'CREATOR20'
]
],
'targeting' => [
'groups' => [
[
'conditions' => [
[
'property' => '877972f8-af4b-4918-95df-d35377234817',
'values' => [
'9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a'
]
]
],
'name' => 'North America'
]
]
],
'content_deadline_date' => '2023-12-25',
'post_deadline_date' => '2023-12-25',
'settings' => [
'creator_approval_required' => true,
'brand_approval_required' => false,
'post_approval_mode' => 'strict',
'completion_mode' => 'all_optional'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"description\": \"<string>\",\n \"instructions\": \"<string>\",\n \"icon_url\": \"<string>\",\n \"brief_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"links\": [\n {\n \"url\": \"https://acme.com/products/glow-serum\",\n \"service\": \"shopify\",\n \"description\": \"Product page to link in bio\",\n \"affiliate_code\": \"CREATOR20\"\n }\n ],\n \"targeting\": {\n \"groups\": [\n {\n \"conditions\": [\n {\n \"property\": \"877972f8-af4b-4918-95df-d35377234817\",\n \"values\": [\n \"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a\"\n ]\n }\n ],\n \"name\": \"North America\"\n }\n ]\n },\n \"content_deadline_date\": \"2023-12-25\",\n \"post_deadline_date\": \"2023-12-25\",\n \"settings\": {\n \"creator_approval_required\": true,\n \"brand_approval_required\": false,\n \"post_approval_mode\": \"strict\",\n \"completion_mode\": \"all_optional\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"description\": \"<string>\",\n \"instructions\": \"<string>\",\n \"icon_url\": \"<string>\",\n \"brief_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"links\": [\n {\n \"url\": \"https://acme.com/products/glow-serum\",\n \"service\": \"shopify\",\n \"description\": \"Product page to link in bio\",\n \"affiliate_code\": \"CREATOR20\"\n }\n ],\n \"targeting\": {\n \"groups\": [\n {\n \"conditions\": [\n {\n \"property\": \"877972f8-af4b-4918-95df-d35377234817\",\n \"values\": [\n \"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a\"\n ]\n }\n ],\n \"name\": \"North America\"\n }\n ]\n },\n \"content_deadline_date\": \"2023-12-25\",\n \"post_deadline_date\": \"2023-12-25\",\n \"settings\": {\n \"creator_approval_required\": true,\n \"brand_approval_required\": false,\n \"post_approval_mode\": \"strict\",\n \"completion_mode\": \"all_optional\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"description\": \"<string>\",\n \"instructions\": \"<string>\",\n \"icon_url\": \"<string>\",\n \"brief_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"links\": [\n {\n \"url\": \"https://acme.com/products/glow-serum\",\n \"service\": \"shopify\",\n \"description\": \"Product page to link in bio\",\n \"affiliate_code\": \"CREATOR20\"\n }\n ],\n \"targeting\": {\n \"groups\": [\n {\n \"conditions\": [\n {\n \"property\": \"877972f8-af4b-4918-95df-d35377234817\",\n \"values\": [\n \"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a\"\n ]\n }\n ],\n \"name\": \"North America\"\n }\n ]\n },\n \"content_deadline_date\": \"2023-12-25\",\n \"post_deadline_date\": \"2023-12-25\",\n \"settings\": {\n \"creator_approval_required\": true,\n \"brand_approval_required\": false,\n \"post_approval_mode\": \"strict\",\n \"completion_mode\": \"all_optional\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "3f8e4567-e89b-12d3-a456-426614174000",
"name": "Spring UGC Push",
"brand_id": "9a2b4567-e89b-12d3-a456-426614174000",
"brand_name": "Acme Skincare",
"status": "active",
"status_detail": {
"reason": "billing_issue",
"occurred_at": "2023-11-07T05:31:56Z"
},
"visibility": "public",
"invite_code": "GLOW2026",
"description": "Short-form UGC for our spring launch.",
"instructions": "Film in daylight and show the product in the first 3 seconds.",
"icon_url": "<string>",
"brief_url": "<string>",
"video_examples": [
"<string>"
],
"links": [
{
"url": "https://acme.com/products/glow-serum",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"service": "shopify",
"description": "Product page to link in bio",
"affiliate_code": "CREATOR20"
}
],
"targeting": {
"groups": [
{
"conditions": [
{
"property": "877972f8-af4b-4918-95df-d35377234817",
"values": [
"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a"
]
}
],
"name": "North America"
}
]
},
"product": {
"name": "Acme Glow Serum",
"url": "https://acme.com/products/glow-serum",
"image_url": "https://cdn.acme.com/glow-serum.png"
},
"spent_cents": 123400,
"accepting_submissions": true,
"content_deadline_date": "2026-03-01",
"post_deadline_date": "2026-03-15",
"settings": {
"creator_approval_required": true,
"brand_approval_required": false,
"post_approval_mode": "strict",
"completion_mode": "all_optional"
},
"tasks": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "15s unboxing video",
"instructions": "Open the package on camera and show your first reaction.",
"platforms": [
"tiktok",
"instagram"
],
"formats": [
"feed_video"
],
"caption": "Obsessed with my new glow ✨ @acmeskincare",
"require_ad_disclosure": true,
"tiktok_sound_url": "<string>",
"instagram_sound_url": "<string>",
"video_examples": [
"<string>"
],
"image_url": "<string>",
"review_mode": "media_review",
"autoreview_prompt": "The product must be clearly visible and mentioned by name.",
"is_required": true,
"max_posts_per_creator": 1,
"display_order": 0,
"status": "active",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"tasks_count": 2,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}Campaigns
Update Campaign
Partially updates a campaign. Omitted fields are unchanged. brand_id is immutable and completed campaigns cannot be updated; everything else is editable in any other status — the same rules as the dashboard editor. Note that updating a pending_approval campaign withdraws the publish request and returns it to draft.
PATCH
/
campaigns
/
{campaign_id}
Update a campaign
curl --request PATCH \
--url https://api.launchpoint.sh/2026-07/campaigns/{campaign_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"visibility": "public",
"invite_code": "<string>",
"description": "<string>",
"instructions": "<string>",
"icon_url": "<string>",
"brief_url": "<string>",
"video_examples": [
"<string>"
],
"links": [
{
"url": "https://acme.com/products/glow-serum",
"service": "shopify",
"description": "Product page to link in bio",
"affiliate_code": "CREATOR20"
}
],
"targeting": {
"groups": [
{
"conditions": [
{
"property": "877972f8-af4b-4918-95df-d35377234817",
"values": [
"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a"
]
}
],
"name": "North America"
}
]
},
"content_deadline_date": "2023-12-25",
"post_deadline_date": "2023-12-25",
"settings": {
"creator_approval_required": true,
"brand_approval_required": false,
"post_approval_mode": "strict",
"completion_mode": "all_optional"
}
}
'import requests
url = "https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}"
payload = {
"name": "<string>",
"visibility": "public",
"invite_code": "<string>",
"description": "<string>",
"instructions": "<string>",
"icon_url": "<string>",
"brief_url": "<string>",
"video_examples": ["<string>"],
"links": [
{
"url": "https://acme.com/products/glow-serum",
"service": "shopify",
"description": "Product page to link in bio",
"affiliate_code": "CREATOR20"
}
],
"targeting": { "groups": [
{
"conditions": [
{
"property": "877972f8-af4b-4918-95df-d35377234817",
"values": ["9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a"]
}
],
"name": "North America"
}
] },
"content_deadline_date": "2023-12-25",
"post_deadline_date": "2023-12-25",
"settings": {
"creator_approval_required": True,
"brand_approval_required": False,
"post_approval_mode": "strict",
"completion_mode": "all_optional"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
visibility: 'public',
invite_code: '<string>',
description: '<string>',
instructions: '<string>',
icon_url: '<string>',
brief_url: '<string>',
video_examples: ['<string>'],
links: [
{
url: 'https://acme.com/products/glow-serum',
service: 'shopify',
description: 'Product page to link in bio',
affiliate_code: 'CREATOR20'
}
],
targeting: {
groups: [
{
conditions: [
{
property: '877972f8-af4b-4918-95df-d35377234817',
values: ['9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a']
}
],
name: 'North America'
}
]
},
content_deadline_date: '2023-12-25',
post_deadline_date: '2023-12-25',
settings: {
creator_approval_required: true,
brand_approval_required: false,
post_approval_mode: 'strict',
completion_mode: 'all_optional'
}
})
};
fetch('https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'visibility' => 'public',
'invite_code' => '<string>',
'description' => '<string>',
'instructions' => '<string>',
'icon_url' => '<string>',
'brief_url' => '<string>',
'video_examples' => [
'<string>'
],
'links' => [
[
'url' => 'https://acme.com/products/glow-serum',
'service' => 'shopify',
'description' => 'Product page to link in bio',
'affiliate_code' => 'CREATOR20'
]
],
'targeting' => [
'groups' => [
[
'conditions' => [
[
'property' => '877972f8-af4b-4918-95df-d35377234817',
'values' => [
'9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a'
]
]
],
'name' => 'North America'
]
]
],
'content_deadline_date' => '2023-12-25',
'post_deadline_date' => '2023-12-25',
'settings' => [
'creator_approval_required' => true,
'brand_approval_required' => false,
'post_approval_mode' => 'strict',
'completion_mode' => 'all_optional'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"description\": \"<string>\",\n \"instructions\": \"<string>\",\n \"icon_url\": \"<string>\",\n \"brief_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"links\": [\n {\n \"url\": \"https://acme.com/products/glow-serum\",\n \"service\": \"shopify\",\n \"description\": \"Product page to link in bio\",\n \"affiliate_code\": \"CREATOR20\"\n }\n ],\n \"targeting\": {\n \"groups\": [\n {\n \"conditions\": [\n {\n \"property\": \"877972f8-af4b-4918-95df-d35377234817\",\n \"values\": [\n \"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a\"\n ]\n }\n ],\n \"name\": \"North America\"\n }\n ]\n },\n \"content_deadline_date\": \"2023-12-25\",\n \"post_deadline_date\": \"2023-12-25\",\n \"settings\": {\n \"creator_approval_required\": true,\n \"brand_approval_required\": false,\n \"post_approval_mode\": \"strict\",\n \"completion_mode\": \"all_optional\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"description\": \"<string>\",\n \"instructions\": \"<string>\",\n \"icon_url\": \"<string>\",\n \"brief_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"links\": [\n {\n \"url\": \"https://acme.com/products/glow-serum\",\n \"service\": \"shopify\",\n \"description\": \"Product page to link in bio\",\n \"affiliate_code\": \"CREATOR20\"\n }\n ],\n \"targeting\": {\n \"groups\": [\n {\n \"conditions\": [\n {\n \"property\": \"877972f8-af4b-4918-95df-d35377234817\",\n \"values\": [\n \"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a\"\n ]\n }\n ],\n \"name\": \"North America\"\n }\n ]\n },\n \"content_deadline_date\": \"2023-12-25\",\n \"post_deadline_date\": \"2023-12-25\",\n \"settings\": {\n \"creator_approval_required\": true,\n \"brand_approval_required\": false,\n \"post_approval_mode\": \"strict\",\n \"completion_mode\": \"all_optional\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launchpoint.sh/2026-07/campaigns/{campaign_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"description\": \"<string>\",\n \"instructions\": \"<string>\",\n \"icon_url\": \"<string>\",\n \"brief_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"links\": [\n {\n \"url\": \"https://acme.com/products/glow-serum\",\n \"service\": \"shopify\",\n \"description\": \"Product page to link in bio\",\n \"affiliate_code\": \"CREATOR20\"\n }\n ],\n \"targeting\": {\n \"groups\": [\n {\n \"conditions\": [\n {\n \"property\": \"877972f8-af4b-4918-95df-d35377234817\",\n \"values\": [\n \"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a\"\n ]\n }\n ],\n \"name\": \"North America\"\n }\n ]\n },\n \"content_deadline_date\": \"2023-12-25\",\n \"post_deadline_date\": \"2023-12-25\",\n \"settings\": {\n \"creator_approval_required\": true,\n \"brand_approval_required\": false,\n \"post_approval_mode\": \"strict\",\n \"completion_mode\": \"all_optional\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "3f8e4567-e89b-12d3-a456-426614174000",
"name": "Spring UGC Push",
"brand_id": "9a2b4567-e89b-12d3-a456-426614174000",
"brand_name": "Acme Skincare",
"status": "active",
"status_detail": {
"reason": "billing_issue",
"occurred_at": "2023-11-07T05:31:56Z"
},
"visibility": "public",
"invite_code": "GLOW2026",
"description": "Short-form UGC for our spring launch.",
"instructions": "Film in daylight and show the product in the first 3 seconds.",
"icon_url": "<string>",
"brief_url": "<string>",
"video_examples": [
"<string>"
],
"links": [
{
"url": "https://acme.com/products/glow-serum",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"service": "shopify",
"description": "Product page to link in bio",
"affiliate_code": "CREATOR20"
}
],
"targeting": {
"groups": [
{
"conditions": [
{
"property": "877972f8-af4b-4918-95df-d35377234817",
"values": [
"9b1f8c72-3d4e-4a2b-8c1a-2f6e5d4c3b2a"
]
}
],
"name": "North America"
}
]
},
"product": {
"name": "Acme Glow Serum",
"url": "https://acme.com/products/glow-serum",
"image_url": "https://cdn.acme.com/glow-serum.png"
},
"spent_cents": 123400,
"accepting_submissions": true,
"content_deadline_date": "2026-03-01",
"post_deadline_date": "2026-03-15",
"settings": {
"creator_approval_required": true,
"brand_approval_required": false,
"post_approval_mode": "strict",
"completion_mode": "all_optional"
},
"tasks": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "15s unboxing video",
"instructions": "Open the package on camera and show your first reaction.",
"platforms": [
"tiktok",
"instagram"
],
"formats": [
"feed_video"
],
"caption": "Obsessed with my new glow ✨ @acmeskincare",
"require_ad_disclosure": true,
"tiktok_sound_url": "<string>",
"instagram_sound_url": "<string>",
"video_examples": [
"<string>"
],
"image_url": "<string>",
"review_mode": "media_review",
"autoreview_prompt": "The product must be clearly visible and mentioned by name.",
"is_required": true,
"max_posts_per_creator": 1,
"display_order": 0,
"status": "active",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"tasks_count": 2,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}{
"error": 123,
"message": "<string>",
"code": "invalid_state_transition"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The campaign ID
Body
application/json
Partial update — omitted fields are unchanged. Arrays (video_examples, links, targeting) are replaced wholesale. brand_id is immutable, and completed campaigns cannot be updated; everything else is editable in any other status, matching the dashboard. Updating a pending_approval campaign withdraws the publish request.
The product this campaign promotes
Show child attributes
Show child attributes
public campaigns appear in creator discovery; unlisted campaigns are reachable only via an access code or direct link
Available options:
public, unlisted Example:
"public"
Custom access code for an unlisted campaign
Replaces the campaign's links
Show child attributes
Show child attributes
Which creators can join the campaign. Groups combine via root_operator; conditions within a group combine via the group's operator. Null means no targeting (open to all).
Show child attributes
Show child attributes
Approval workflow and task-completion settings
Show child attributes
Show child attributes
Response
The updated campaign
Example:
"3f8e4567-e89b-12d3-a456-426614174000"
Example:
"Spring UGC Push"
Example:
"9a2b4567-e89b-12d3-a456-426614174000"
Example:
"Acme Skincare"
Campaign lifecycle status. draft → pending_approval (submitted for Launchpoint review) → active ⇄ paused → completed. A denied publish returns the campaign to draft with status_detail populated.
Available options:
draft, pending_approval, active, paused, completed Example:
"active"
Why the campaign is in its current status. Null unless the campaign was auto-paused or a publish request was denied.
Show child attributes
Show child attributes
public campaigns appear in creator discovery; unlisted campaigns are reachable only via an access code or direct link
Available options:
public, unlisted Example:
"public"
Access code creators use to join an unlisted campaign. Null for public campaigns.
Example:
"GLOW2026"
What the campaign is about, shown to creators
Example:
"Short-form UGC for our spring launch."
Campaign-wide instructions for creators
Example:
"Film in daylight and show the product in the first 3 seconds."
Campaign icon shown to creators
Link to an external full brief document
Campaign-level example video URLs
Links given to creators alongside the brief
Show child attributes
Show child attributes
Which creators can join the campaign. Groups combine via root_operator; conditions within a group combine via the group's operator. Null means no targeting (open to all).
Show child attributes
Show child attributes
The product this campaign promotes
Show child attributes
Show child attributes
Total paid to creators on this campaign, in cents. Read-only.
Example:
123400
Whether new creators can currently start work. Controlled by pause/resume.
Example:
true
Date by which creators must submit content for review
Example:
"2026-03-01"
Date by which approved content must be posted
Example:
"2026-03-15"
Approval workflow and task-completion settings
Show child attributes
Show child attributes
The campaign's tasks. Embedded when fetching a single campaign; omitted in list responses (use tasks_count).
Show child attributes
Show child attributes
Example:
2
⌘I