campaigns

Create or update a campaign (e.g. name='Q2 Outreach'). Omit campaign_id to create; provide it to update. Creation fails

post/api/v1/campaigns/upsert

Request

  • Base URL: https://crispy.sh
  • URL: https://crispy.sh/api/v1/campaigns/upsert
  • Auth: HTTP bearer

Request body

campaign_idstring

Campaign ID to update. Omit to create a new campaign.

idstring

Optional URL-safe slug for creation (3-50 chars: lowercase a-z, 0-9, hyphens; starts/ends alphanumeric). Auto-derived from name when omitted. Provide to override or to resolve a name collision.

namestring

Campaign name (required for creation; the slug id is derived from it).

kind'acquisition' | 'relationship'

REQUIRED for creation. 'acquisition' = invite-based outreach to new 1st-degrees (filters out existing connections). 'relationship' = DM-only to existing 1st-degree connections (requires DISTANCE_1).

list_idstring

Existing list ID to use as prospect source (alternative to contacts).

contactsobject[]

Inline ContactRef array for creation (alternative to list_id).

follow_up_sequenceobject[]

Post-acceptance (or relationship DM) steps to persist. Replaces stored follow_up_sequence. Pass [] to clear. Each step needs type and delay_seconds; text steps need content.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.