Incluir uma Conexão
POST/v2/admin/connections
Cadastra uma nova conexão com um provedor financeiro.
Processamento Assíncrono: a resposta
201é retornada antes de as credenciais serem validadas junto ao provedor. A conexão nasce comvalidated_atevalidate_failed_atnulos, e a validação termina em segundo plano.
Ciclo de validação
| Estado | validated_at | validate_failed_at |
|---|---|---|
| Validando | null | null |
| Validada | preenchido | null |
| Falhou | null | preenchido |
Quando a validação é bem-sucedida, enabled_at também é preenchido, mesmo que a conexão tenha sido criada com enabled: false.
Eventos de Webhook
integration.connection.db.created: disparado nesta operação, com a conexão ainda não validada.integration.connection.db.updated: disparado quando a validação termina, com sucesso ou falha. Leia o desfecho emobject.validated_ateobject.validate_failed_at: a falha não aparece emchanges.
Request
Responses
- 201
- 401
- 403
- 422
Conexão criada
Falha de autenticação. Token inválido
Falha de permissão. Você não tem o Scope obrigatório para essa chamada.
Dados da conexão inválidos