Create a campaign
curl --request POST \
--url https://api.launchpoint.sh/2026-07/campaigns \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Spring UGC Push",
"visibility": "public",
"invite_code": "<string>",
"brand_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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"
},
"tasks": [
{
"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
}
]
}
'import requests
url = "https://api.launchpoint.sh/2026-07/campaigns"
payload = {
"name": "Spring UGC Push",
"visibility": "public",
"invite_code": "<string>",
"brand_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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"
},
"tasks": [
{
"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
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Spring UGC Push',
visibility: 'public',
invite_code: '<string>',
brand_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
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'
},
tasks: [
{
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
}
]
})
};
fetch('https://api.launchpoint.sh/2026-07/campaigns', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Spring UGC Push',
'visibility' => 'public',
'invite_code' => '<string>',
'brand_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'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'
],
'tasks' => [
[
'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
]
]
]),
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"
payload := strings.NewReader("{\n \"name\": \"Spring UGC Push\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"brand_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"tasks\": [\n {\n \"title\": \"15s unboxing video\",\n \"instructions\": \"Open the package on camera and show your first reaction.\",\n \"platforms\": [\n \"tiktok\",\n \"instagram\"\n ],\n \"formats\": [\n \"feed_video\"\n ],\n \"caption\": \"Obsessed with my new glow ✨ @acmeskincare\",\n \"require_ad_disclosure\": true,\n \"tiktok_sound_url\": \"<string>\",\n \"instagram_sound_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"image_url\": \"<string>\",\n \"review_mode\": \"media_review\",\n \"autoreview_prompt\": \"The product must be clearly visible and mentioned by name.\",\n \"is_required\": true,\n \"max_posts_per_creator\": 1,\n \"display_order\": 0\n }\n ]\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.launchpoint.sh/2026-07/campaigns")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Spring UGC Push\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"brand_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"tasks\": [\n {\n \"title\": \"15s unboxing video\",\n \"instructions\": \"Open the package on camera and show your first reaction.\",\n \"platforms\": [\n \"tiktok\",\n \"instagram\"\n ],\n \"formats\": [\n \"feed_video\"\n ],\n \"caption\": \"Obsessed with my new glow ✨ @acmeskincare\",\n \"require_ad_disclosure\": true,\n \"tiktok_sound_url\": \"<string>\",\n \"instagram_sound_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"image_url\": \"<string>\",\n \"review_mode\": \"media_review\",\n \"autoreview_prompt\": \"The product must be clearly visible and mentioned by name.\",\n \"is_required\": true,\n \"max_posts_per_creator\": 1,\n \"display_order\": 0\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launchpoint.sh/2026-07/campaigns")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Spring UGC Push\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"brand_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"tasks\": [\n {\n \"title\": \"15s unboxing video\",\n \"instructions\": \"Open the package on camera and show your first reaction.\",\n \"platforms\": [\n \"tiktok\",\n \"instagram\"\n ],\n \"formats\": [\n \"feed_video\"\n ],\n \"caption\": \"Obsessed with my new glow ✨ @acmeskincare\",\n \"require_ad_disclosure\": true,\n \"tiktok_sound_url\": \"<string>\",\n \"instagram_sound_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"image_url\": \"<string>\",\n \"review_mode\": \"media_review\",\n \"autoreview_prompt\": \"The product must be clearly visible and mentioned by name.\",\n \"is_required\": true,\n \"max_posts_per_creator\": 1,\n \"display_order\": 0\n }\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
Create Campaign
Creates a campaign in draft status. Drafts can be skeletal — tasks may be added later — but a campaign must have at least one active task before it can be published. Requires the campaigns:write scope. Agency keys must specify brand_id.
POST
/
campaigns
Create a campaign
curl --request POST \
--url https://api.launchpoint.sh/2026-07/campaigns \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Spring UGC Push",
"visibility": "public",
"invite_code": "<string>",
"brand_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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"
},
"tasks": [
{
"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
}
]
}
'import requests
url = "https://api.launchpoint.sh/2026-07/campaigns"
payload = {
"name": "Spring UGC Push",
"visibility": "public",
"invite_code": "<string>",
"brand_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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"
},
"tasks": [
{
"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
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Spring UGC Push',
visibility: 'public',
invite_code: '<string>',
brand_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
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'
},
tasks: [
{
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
}
]
})
};
fetch('https://api.launchpoint.sh/2026-07/campaigns', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Spring UGC Push',
'visibility' => 'public',
'invite_code' => '<string>',
'brand_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'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'
],
'tasks' => [
[
'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
]
]
]),
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"
payload := strings.NewReader("{\n \"name\": \"Spring UGC Push\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"brand_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"tasks\": [\n {\n \"title\": \"15s unboxing video\",\n \"instructions\": \"Open the package on camera and show your first reaction.\",\n \"platforms\": [\n \"tiktok\",\n \"instagram\"\n ],\n \"formats\": [\n \"feed_video\"\n ],\n \"caption\": \"Obsessed with my new glow ✨ @acmeskincare\",\n \"require_ad_disclosure\": true,\n \"tiktok_sound_url\": \"<string>\",\n \"instagram_sound_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"image_url\": \"<string>\",\n \"review_mode\": \"media_review\",\n \"autoreview_prompt\": \"The product must be clearly visible and mentioned by name.\",\n \"is_required\": true,\n \"max_posts_per_creator\": 1,\n \"display_order\": 0\n }\n ]\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.launchpoint.sh/2026-07/campaigns")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Spring UGC Push\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"brand_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"tasks\": [\n {\n \"title\": \"15s unboxing video\",\n \"instructions\": \"Open the package on camera and show your first reaction.\",\n \"platforms\": [\n \"tiktok\",\n \"instagram\"\n ],\n \"formats\": [\n \"feed_video\"\n ],\n \"caption\": \"Obsessed with my new glow ✨ @acmeskincare\",\n \"require_ad_disclosure\": true,\n \"tiktok_sound_url\": \"<string>\",\n \"instagram_sound_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"image_url\": \"<string>\",\n \"review_mode\": \"media_review\",\n \"autoreview_prompt\": \"The product must be clearly visible and mentioned by name.\",\n \"is_required\": true,\n \"max_posts_per_creator\": 1,\n \"display_order\": 0\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.launchpoint.sh/2026-07/campaigns")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Spring UGC Push\",\n \"visibility\": \"public\",\n \"invite_code\": \"<string>\",\n \"brand_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\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 \"tasks\": [\n {\n \"title\": \"15s unboxing video\",\n \"instructions\": \"Open the package on camera and show your first reaction.\",\n \"platforms\": [\n \"tiktok\",\n \"instagram\"\n ],\n \"formats\": [\n \"feed_video\"\n ],\n \"caption\": \"Obsessed with my new glow ✨ @acmeskincare\",\n \"require_ad_disclosure\": true,\n \"tiktok_sound_url\": \"<string>\",\n \"instagram_sound_url\": \"<string>\",\n \"video_examples\": [\n \"<string>\"\n ],\n \"image_url\": \"<string>\",\n \"review_mode\": \"media_review\",\n \"autoreview_prompt\": \"The product must be clearly visible and mentioned by name.\",\n \"is_required\": true,\n \"max_posts_per_creator\": 1,\n \"display_order\": 0\n }\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.
Headers
A unique key (max 255 characters) to safely retry the request. Repeating a request with the same key within 24 hours returns the original response with an Idempotent-Replay: true header. Reusing a key with a different body returns 409.
Maximum string length:
255Body
application/json
Example:
"Spring UGC Push"
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. Optional — one is generated if omitted.
The brand this campaign belongs to. Required for agency keys; optional for brand keys (must match the key's own brand if present).
The product this campaign promotes
Show child attributes
Show child attributes
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
Must be on or before post_deadline_date
Approval workflow and task-completion settings
Show child attributes
Show child attributes
Tasks to create with the campaign. Optional — drafts can be created without tasks. Publishing requires at least one active task unless the campaign requires creator approval (waitlist).
Show child attributes
Show child attributes
Response
The created 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