Endpoint: POST /unified/accounts/sellers/{sellers_pk}/invitation-links/
Autenticação: JWT obrigatório ou Chave de API aceita
Cria um link de convite pertencente ao sellers_pk. O link é identificado por um short_id gerado automaticamente (8 letras/dígitos minúsculos) e preenche previamente um subconjunto de campos aplicados quando uma nova conta é cadastrada por meio dele. Consulte Onboarding de sellers para o fluxo completo de cadastro. O creator é definido automaticamente a partir da URL — não envie esse campo no corpo da requisição. Definir agent, n1_distributor, n2_distributor, plan ou parent exige permissões granulares específicas atribuídas ao grupo de acesso do solicitante (register_account_choose_agent, register_account_choose_n1, register_account_choose_n2, register_account_choose_plan, register_account_sub).

​
Parâmetros de path

​
sellers_pk
string (uuid)
required
Conta unificada que será dona (criadora) do link de convite.

​
Corpo

​
name
string
required
Rótulo livre exibido no painel.
​
agent
string (uuid)
Agente predefinido (opcional) para o split da nova conta. Requer a permissão register_account_choose_agent.
​
n1_distributor
string (uuid)
Distribuidor N1 predefinido (opcional). Requer register_account_choose_n1.
​
n2_distributor
string (uuid)
Distribuidor N2 predefinido (opcional). Requer register_account_choose_n2.
​
plan
string (uuid)
Plano de split predefinido (opcional). Requer register_account_choose_plan.
​
parent
string (uuid)
Conta pai predefinida (opcional). Se definida, contas cadastradas pelo link viram sub-contas deste pai (seu type é rebaixado para SUB_SELLER_*). Requer register_account_sub.

​
Resposta

201 Created. Retorna o novo link de convite.
​
id
string (uuid)
​
short_id
string
Gerado automaticamente. Somente leitura. Use como identificador público ao distribuir o link.
​
name
string
​
agent
string (uuid) | null
​
n1_distributor
string (uuid) | null
​
n2_distributor
string (uuid) | null
​
plan
string (uuid) | null
​
parent
string (uuid) | null
​
created_at
string
​
updated_at
string
{
  "id": "44aa11b2-9c70-4f5b-8e21-12c8f7d9b1a2",
  "short_id": "k3p9q1xy",
  "name": "Força de vendas – Região SP",
  "agent": "ag-1111-...",
  "n1_distributor": null,
  "n2_distributor": null,
  "plan": "pl-1111-...",
  "parent": null,
  "created_at": "2025-04-12T10:00:00.000000Z",
  "updated_at": "2025-04-12T10:00:00.000000Z"
}

​
Erros

StatusQuando
400Algum campo de pré-preenchimento referencia uma conta / plano que não existe; ou o solicitante não possui a permissão necessária para definir aquele campo.
401Token ausente ou inválido.
403Solicitante não tem acesso a sellers_pk.
404sellers_pk não existe.

​
Exemplos

curl -X POST https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/invitation-links/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Força de vendas – Região SP",
    "agent": "ag-1111-2222-3333-4444",
    "plan": "pl-aaaa-bbbb-cccc-dddd"
  }'