capabilities.work

Provision a New Agent

A 3-step recipe with Assembled. We can help you get access.

Recipe · 3 steps

Provision a New Agent

Create a new agent with a valid role and verify the created record.

  1. List all roles available in the organization so a valid role can be assigned to the new agent.
  2. Create a single new agent with the supplied email, name, channels, and role. Falls back to the first available role when none is supplied.
  3. Retrieve the newly created agent to confirm the role assignment and that the account is active.
What you'll need to have ready
  • apiKey: Assembled API key (sk_live_...) used as the HTTP Basic Auth username.
  • email: Email address for the new agent.
  • name: Display name for the new agent.
  • roleId: Role ID to assign; if omitted the first available role is used.
  • channels: Channels the agent can be routed to (phone, email, chat, sms, social, back_office).
For your developer

Arazzo workflow assembled:provision-agent, 3 operations: listRoles → createPeople → getPerson. Specs on APIs.io.