business

Generate customers

Generate new customers for a business profile, each billed as one Customers interaction, from its current profile (source current) or a generation profile such as a forecast or CRM import (source artifact); optionally name a new audience or existing audiences to put them in. A member or an API key with business:write may start it; a key's run names no member. Returns the run; follow it with platform_runs_get_v2, then list the customers.

post/api/v1/business/customers/generate

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/business/customers/generate
  • Auth: one of:
    • HTTP bearer
    • 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

businessProfileIdstring uuid required
targetCountinteger required

Customers to generate (1–5000)

source'current' | 'artifact' | 'rows'

current generates from the profile's current version; artifact from generationProfileId; rows makes one customer per row in rows, keeping what each row states

generationProfileIdstring uuid nullable

The generation profile (a forecast, CRM import, or Manual Profile) to use

assignGroupIdsstring[]

Existing audiences the new customers join; not with groupName

groupNamestring

A new audience the new customers join; not with assignGroupIds

Response

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

runIdstring uuid required
businessProfileIdstring uuid required
targetCountinteger required
groupNamestring nullable required
customerRunIdstring uuid

With source rows, the Customer run that makes the customers

Changes

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