discovery

Launch campaigns (v2)

Start a Discovery campaign for a website or an existing business profile (url may be null when businessProfileId is supplied), for an organization whose Analytics subscription already admits work and whose payment method is on file. Its conversations accrue against the organization's Analytics plan as they run. This never subscribes, applies an offer, or asks for a card: an organization without an active subscription or saved payment method is refused and subscribes in the Point11 dashboard first. A retry with the same Idempotency-Key answers the same campaign, through this version or v1. Change a running campaign's settings with discovery_campaign_settings_update_v2. Returns the campaign; its setup runs in the background.

post/api/v1/discovery/campaigns/launch-v2

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/discovery/campaigns/launch-v2
  • Auth: OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Idempotency-Keystring uuid required

UUID naming this intent. Retry with the same key; reuse for other input is 409.

Request body

expectedMonthlyPriceCentsinteger

The Analytics monthly price the caller reviewed, in cents; a launch whose current price differs is refused (reason PRICE_CHANGED).

Response

Accepted: the durable run started. Follow it with GET /api/v1/platform/runs-v2/{id}.

runIdstring nullable required

The billing run the launch dispatched, or null: campaign setup is a background workflow, not a billing run, and bills its conversations as they are admitted.

status'setup_started' required

setup_started: the campaign exists and its setup runs in the background (a retry of a launch already started answers the same).

campaignIdstring uuid required

The started campaign. Its first entry is admitted once its setup finishes, after this response; list its entries with campaigns.campaign-entries.list.v1.

Changes

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