Pular para o conteúdo principal
Integradores no Business Plan ou Enterprise Plan podem fazer o onboarding das contas sociais dos seus clientes sob sub-profiles. Usando o MCP Server, um agente cria um sub-profile, o direciona e gera uma URL de vinculação com single sign-on que o cliente abre para conectar suas contas.

​
Fluxo

1

Crie um sub-profile

Chame create_profile (nível de conta — sem profileKey). Ele retorna uma profile key para o novo sub-profile.
2

Direcione para o sub-profile

Use a profile key retornada nas chamadas seguintes — seja via o header Profile-Key na conexão ou como argumento profileKey por chamada. Veja Conectar e Configurar para a precedência.
3

Gere uma URL de vinculação social

Chame generate_jwt_social_linking_url para gerar uma URL de vinculação com single sign-on. A chave de assinatura JWT e o domínio de onboarding são derivados no servidor — o chamador não fornece headers X-Ayrshare-* nem chave privada ou domínio.
4

O cliente vincula suas contas

O cliente abre a URL e autoriza (OAuth) suas contas sociais. As contas conectadas são vinculadas ao sub-profile.

​
Requisitos

generate_jwt_social_linking_url exige uma profileKey. Se nenhuma for resolvida, a chamada retorna 400 com a mensagem “Profile Key is required…”.Um domínio de vinculação social deve estar provisionado para sua conta. Isso está disponível nos planos Business e Enterprise.

​
Estados de erro

CondiçãoResposta
Nenhum domínio provisionado400 — “No social-linking domain is provisioned for this account (available on Business/Enterprise plans).”
Nenhuma chave de assinatura400 — “No signing key found for this account’s social-linking domain.”

​
Próximos passos

Conectar e Configurar

Autenticação e direcionamento de profile.

Catálogo de Tools

As 27 tools agrupadas por domínio, com escopo e propósito.