Campaigns
v1
Update Campaign
Update a specific campaign using its campaign ID. Supports changes to campaign attributes such as name, budget, status, associated list or custom feed, and campaign settings.
:::info Requires the campaigns:write OAuth2 scope. :::
patch/v1/campaigns/{id}
Path parameters
idstring required
The campaign ID.
Query parameters
account_idstring required
The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
Request body
Example request
{
"data": {
"relationships": {
"list": {
"id": "company_42"
},
"campaign_settings": {
"id": "1234"
}
}
}
}Response
Success
Example response
{
"data": {
"type": "campaign",
"id": "1234",
"attributes": {
"name": "Q2 EMEA enterprise push",
"status": "draft",
"start_date": "2026-05-01T00:00:00Z",
"end_date": "2026-08-01T00:00:00Z",
"location_type": "global",
"budget_type": "total",
"budget": 1000,
"total_budget": 1000,
"budget_left": 1000,
"currency": "EUR",
"created_at": "2026-04-01T09:15:00Z",
"updated_at": "2026-04-12T11:30:00Z"
},
"relationships": {
"created_by": {
"id": "12345"
},
"list": {
"id": "company_42"
},
"custom_feed": {
"id": "feed-100"
},
"campaign_settings": {
"id": "1234"
},
"campaign_summary": {
"id": "1234"
},
"campaign_locations": [
{
"id": "98765"
}
]
}
},
"meta": {
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}