> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/topicos/api/api-como-relacionar-um-objeto-customizado-a-um-contato.md).

# API - Como Relacionar um Objeto Customizado a um Contato

Como relacionar um Objeto Customizado existente a um contato.

### Rota

<mark style="color:green;">`POST`</mark> `/customobjects/link?apitoken=seu-token&i=sua-instancia`

### Query Params

<table><thead><tr><th width="291">Key/Chave</th><th width="450">Descrição</th></tr></thead><tbody><tr><td>i</td><td>Identificador da sua instância, subdomínio.</td></tr><tr><td>apitoken</td><td>Token da API.</td></tr></tbody></table>

### Body

<table><thead><tr><th width="291">Key/Chave</th><th width="450">Descrição</th></tr></thead><tbody><tr><td>objectId</td><td>ID do Objeto criado. Caso ele tenha sido criado via API, é retornado por <a href="https://docs.sprinthub.com/topicos/api/api-como-criar-um-objeto-customizado.md">esta chamada</a>.</td></tr><tr><td>linkType</td><td>Deve ser <code>"lead"</code>.</td></tr><tr><td>targetId</td><td>ID do contato dentro da Sprinthub que vai ser relacionado ao Objeto Customizado.</td></tr><tr><td>amount</td><td>Deve ser <code>1</code>.</td></tr></tbody></table>

## Testando Relacionamento de Objeto Customizado

O envio da requisição foi realizado utilizando o software *Postman*. A resposta esperada é um objeto representando o a relação Objeto com o lead.

<div data-with-frame="true"><figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2Foe1Goo6lPIUCnGbkNGp3%2FScreenshot_3.png?alt=media&amp;token=d71ba42b-bb14-4f14-bbdc-bfcbc421cf6a" alt=""><figcaption><p><em>Requisição para relacionar Objeto Customizado a um contato.</em></p></figcaption></figure></div>

### Verificando nos Dados Completos do Lead

Ao relacionar um Objeto Customizado a um contato, ele deve parecer como na imagem abaixo.

<div data-with-frame="true"><figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2F9bUSxlAJFeIdD76wmwXZ%2FScreenshot_4.png?alt=media&amp;token=05d4d2cd-3da2-4681-bf70-8884ebeb17a1" alt=""><figcaption><p><em>Aba do Objeto Customizado dentro do contato.</em></p></figcaption></figure></div>
