Copy an agent to a sub-account

curl --request POST \
  --url https://api.getnexor.ai/api/public/sub-accounts/{sub_account_id}/agents/duplicate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "source": {
    "master_workflow_id": "55555555-5555-4555-8555-555555555555"
  },
  "names": {
    "principal": "Sofía Andes"
  },
  "confirm": true
}
'

{
  "status": "created",
  "master_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workflow_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "next_steps": [
    {
      "code": "<string>",
      "owner": "<string>",
      "blocking": true,
      "blocks": [
        "<string>"
      ],
      "label": {
        "en": "<string>",
        "es": "<string>"
      },
      "detail": {
        "en": "<string>",
        "es": "<string>"
      }
    }
  ],
  "missing_connections": [
    {
      "resource_type": "<string>",
      "agent_ref": "<string>",
      "resource_name": "<string>",
      "fields": [
        "<string>"
      ]
    }
  ]
}

{
  "status": "created",
  "master_workflow_id": "55555555-5555-4555-8555-555555555555",
  "workflow_ids": [
    "33333333-3333-4333-8333-333333333333",
    "44444444-4444-4444-8444-444444444444"
  ],
  "next_steps": [
    {
      "code": "whatsapp_number",
      "owner": "client",
      "blocking": true,
      "blocks": [
        "whatsapp"
      ],
      "label": {
        "es": "Conectar el número de WhatsApp",
        "en": "Connect the WhatsApp number"
      },
      "detail": {
        "es": "El número y la cuenta de WhatsApp pertenecen al cliente origen. Selecciona un número activo del cliente destino.",
        "en": "The WhatsApp number and account belong to the source client. Select an active number from the target client."
      }
    }
  ],
  "missing_connections": [
    {
      "resource_type": "client_whatsapp_number",
      "agent_ref": null,
      "resource_name": "whatsapp_number",
      "fields": []
    }
  ]
}

{
  "error": "invalid_source"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "sub_accounts_not_enabled"
}

{
  "error": "source_not_found"
}

{
  "error": "sub_account_inactive"
}

{
  "error": "referral_agent_not_duplicable"
}

{
  "error": "internal_error"
}

POST

sub-accounts

{sub_account_id}

agents

duplicate

curl --request POST \
  --url https://api.getnexor.ai/api/public/sub-accounts/{sub_account_id}/agents/duplicate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "source": {
    "master_workflow_id": "55555555-5555-4555-8555-555555555555"
  },
  "names": {
    "principal": "Sofía Andes"
  },
  "confirm": true
}
'

{
  "status": "created",
  "master_workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workflow_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "next_steps": [
    {
      "code": "<string>",
      "owner": "<string>",
      "blocking": true,
      "blocks": [
        "<string>"
      ],
      "label": {
        "en": "<string>",
        "es": "<string>"
      },
      "detail": {
        "en": "<string>",
        "es": "<string>"
      }
    }
  ],
  "missing_connections": [
    {
      "resource_type": "<string>",
      "agent_ref": "<string>",
      "resource_name": "<string>",
      "fields": [
        "<string>"
      ]
    }
  ]
}

{
  "status": "created",
  "master_workflow_id": "55555555-5555-4555-8555-555555555555",
  "workflow_ids": [
    "33333333-3333-4333-8333-333333333333",
    "44444444-4444-4444-8444-444444444444"
  ],
  "next_steps": [
    {
      "code": "whatsapp_number",
      "owner": "client",
      "blocking": true,
      "blocks": [
        "whatsapp"
      ],
      "label": {
        "es": "Conectar el número de WhatsApp",
        "en": "Connect the WhatsApp number"
      },
      "detail": {
        "es": "El número y la cuenta de WhatsApp pertenecen al cliente origen. Selecciona un número activo del cliente destino.",
        "en": "The WhatsApp number and account belong to the source client. Select an active number from the target client."
      }
    }
  ],
  "missing_connections": [
    {
      "resource_type": "client_whatsapp_number",
      "agent_ref": null,
      "resource_name": "whatsapp_number",
      "fields": []
    }
  ]
}

{
  "error": "invalid_source"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "sub_accounts_not_enabled"
}

{
  "error": "source_not_found"
}

{
  "error": "sub_account_inactive"
}

{
  "error": "referral_agent_not_duplicable"
}

{
  "error": "internal_error"
}

Send exactly one source:

master_workflow_id copies an agent with all its tasks. In the API an agent is a master_workflow.
workflow_id copies a single task. In the API a task is a workflow.

{ "source": { "master_workflow_id": "55555555-5555-4555-8555-555555555555" }, "confirm": true }

What the copy includes

The copy keeps the configuration, stages, fields, tools, and rules of the source, and it is created paused, so it does not contact anyone yet. Connections bound to your main account are not copied: WhatsApp and phone numbers, channels, integrations, knowledge bases, offers, and hosts. next_steps and missing_connections list what the sub-account must connect. Steps with blocking: true stop the channels listed in blocks until they are done. After connecting what is missing, set the tasks live from inside the sub-account. A deactivated sub-account returns 409 sub_account_inactive. Reactivate it first with Reactivate sub-account. For the feature gate, scopes, and confirm, see Before you start.

Authorizations

X-API-Key

string

header

required

API key for authentication. Keys are prefixed with nxr_live_.

Path Parameters

sub_account_id

string<uuid>

required

Sub-account ID, from items[].id in List sub-accounts. A malformed ID returns 400 invalid_sub_account_id.

Body

application/json

source

object

required

What to copy. Send exactly one of the two IDs.

Show child attributes

confirm

enum<boolean>

required

Must be true.

Available options:

true

names

object

Optional new names for the copy. principal sets the name of the copied agent. Leave it out to keep the source names.

Show child attributes

Response

status: "existed": the copy already existed; nothing new was created.

status

enum<string>

required

Available options:

created,

existed

master_workflow_id

string<uuid> | null

required

The copied agent in the sub-account. null when the source was a single task.

workflow_ids

string<uuid>[]

required

The copied tasks in the sub-account, all paused.

next_steps

object[]

required

What the sub-account must set up before the copy goes live. blocking: true steps stop the channels listed in blocks.

Show child attributes

missing_connections

object[]

required

Connections and credentials that were left out of the copy.

Show child attributes

Last modified on October 1, 2026

Start here

Quickstart

API reference

Build and launch

WhatsApp

Channels

Agents

Meetings

Integrations

Account

Inbox

Developer tools

Support reference

Copy an agent to a sub-account

What the copy includes

Authorizations

Path Parameters

Body

Response

​What the copy includes

Authorizations

Path Parameters

Body

Response

What the copy includes