Skip to main content

Create an actor

POST 
/v1/projects/:project_id/actors

Creates the actor, or returns the one that already carries this external_id. Idempotent on that key: a retry returns the existing actor with 200 rather than creating a second one, so this is safe as the first call your backend makes when it sees a new user. external_id may not start with a channel prefix (whatsapp:, discord:, …) or address: — those name actors that belong to an address, which owns its own.

Request​

Responses​

An actor with this external_id already existed.