> For the complete documentation index, see [llms.txt](https://developers.frill.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.frill.co/api/reference/integration-links.md).

# Integration Links

## Integration link object

Integration links have the following fields

| Field                                         | Details                                                                                                                                                             |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>idx</strong><br>string</p>         | A unique identifier for the integration link                                                                                                                        |
| <p><strong>idea\_idx</strong><br>string</p>   | A unique identifier for the idea this link belongs to                                                                                                               |
| <p><strong>type</strong><br>string</p>        | The integration this link points at. Currently `zendesk` or `intercom`. Not validated on write, so other values may be present.                                     |
| <p><strong>link\_ref</strong><br>string</p>   | The identifier of the linked record in the external system — for Zendesk, the ticket ID.                                                                            |
| <p><strong>meta</strong><br>object</p>        | Additional detail supplied by the integration when the link was created. Shape varies by integration and is not validated by Frill, so treat every key as optional. |
| <p><strong>created\_at</strong><br>string</p> | The date & time the link was created in UTC timezone                                                                                                                |
| <p><strong>updated\_at</strong><br>string</p> | The date & time the link was last updated (UTC timezone)                                                                                                            |

One row is returned per external record, each carrying its own `idea_idx`, so an idea with three Zendesk tickets returns three rows.

{% hint style="info" %}
At least one of `idea_idx` or `type` must be supplied. Use `idea_idx` to fetch the links for a single idea, or `type` to page through every link of that integration type across your account and group them by `idea_idx` yourself.
{% endhint %}

### Endpoints

You can use the following endpoint to read Integration Links

{% openapi src="/files/QCtDcTbC6vmEobQaETqR" path="/integration-links" method="get" %}
[integration\_links.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-556b671dbd3a3493cb0c613bde85cb09047d0ee2%2Fintegration_links.yaml?alt=media)
{% endopenapi %}