Campaigns

Update a campaign

PATCH

/api/v1/campaigns/{campaignId}

Path parameters

campaignId

required

string · uuid

Campaign id

Request bodyrequired

nameoptional

string

statusoptional

"active" | "paused"

graphoptional

object

nodesrequired

object[]

edgesrequired

object[]

scheduleoptional

object

workingDaysoptional

integer[]

startTimeoptional

string

endTimeoptional

string

limitsoptional

object

minGapSecondsoptional

integer

maxGapSecondsoptional

integer

maxNewLeadsPerDayoptional

integer | null

suppressionPolicyoptional

object

bypassSuppressionReasonsoptional

"manual" | "unsubscribed" | "not_interested" | "existing_customer" | "open_opportunity" | "competitor" | "employee" | "invalid_recipient" | "complained" | "recently_contacted" | "unresponsive"[]

cooldownDaysoptional

integer

unresponsiveAfterTouchesoptional

integer

autoSuppressKeywordsoptional

string[]

dryRunoptional

boolean

Response

200Updated campaign.

campaign

object

id

string · uuid

ownerOrgId

string · uuid

name

string

status

"draft" | "active" | "paused" | "completed" | "archived"

graph

object

nodes

object[]

edges

object[]

schedule

object

workingDays

integer[]

startTime

string

endTime

string

limits

object

minGapSeconds

integer

maxGapSeconds

integer

maxNewLeadsPerDayoptional

integer | null

suppressionPolicy

object

bypassSuppressionReasons

"manual" | "unsubscribed" | "not_interested" | "existing_customer" | "open_opportunity" | "competitor" | "employee" | "invalid_recipient" | "complained" | "recently_contacted" | "unresponsive"[]

cooldownDays

integer

unresponsiveAfterTouches

integer

autoSuppressKeywords

string[]

dryRun

boolean

startedAt

string · date-time | null

startedBy

string · uuid | null

pausedAt

string · date-time | null

pausedBy

string · uuid | null

completedAt

string · date-time | null

archivedAt

string · date-time | null

archivedBy

string · uuid | null

createdAt

string · date-time

createdBy

string · uuid | null

updatedAt

string · date-time

updatedBy

string · uuid | null

connectedAccounts

object[]

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy