Get or create a user actor

post

https://api.newo.ai/api/v1/actors/user/get-or-create

Returns the existing user actor if one matching the given external_id,
integration_idn, and connector_idn already exists; otherwise creates and
returns a new one. Returns 200 if found, 201 if created.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Display name of the actor

external_id

string

required

Your system's identifier for this user. Used to look up the actor later
without storing Newo's internal UUID. Must be unique per
integration/connector combination.

integration_idn

string

required

^[a-zA-Z_][a-zA-Z0-9_]*$

A slug-style identifier used throughout the Newo platform for integrations,
connectors, flows, skills, and more. Must start with a letter or underscore;
subsequent characters may be letters, digits, or underscores.

connector_idn

string

required

^[a-zA-Z_][a-zA-Z0-9_]*$

time_zone_identifier

string

IANA time zone identifier (e.g. America/New_York).
See the tz database list.

Responses

200Existing actor returned

201New actor created

4XXNewo API error