Integration Links

Integration links connect an Idea to a record in an external tool — for example the Zendesk tickets or Intercom conversations that prompted a piece of feedback.

Integration link object

Integration links have the following fields

Field	Details
idx string	A unique identifier for the integration link
idea_idx string	A unique identifier for the idea this link belongs to
type string	The integration this link points at. Currently zendesk or intercom. Not validated on write, so other values may be present.
link_ref string	The identifier of the linked record in the external system — for Zendesk, the ticket ID.
meta object	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.
created_at string	The date & time the link was created in UTC timezone
updated_at string	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.

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.

Endpoints

You can use the following endpoint to read Integration Links

get

Returns a list of links between ideas and external integration records — for example the Zendesk tickets linked to an idea.

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 the company (each row carries its own idea_idx, so results can be grouped by idea client-side).

Authorizations

AuthorizationstringRequired

API key in Authorization header with Bearer prefix (recommended)

Query parameters

limitinteger · min: 1 · max: 100Optional

Limits the number of items on a page

Default: 20

afterstringOptional

The after cursor - used for pagination. Pass the previous response's pagination.endCursor.

idea_idxstringOptional

A unique identifier for the idea. Only fetch links for this idea. Required unless type is supplied.

typestring · max: 255Optional

Only fetch links of this integration type, e.g. zendesk. Required unless idea_idx is supplied.

Responses

200

Successfully returned a list of integration links

application/json

400

Invalid request

application/json

404

The requested idea could not be found

application/json

422

Neither idea_idx nor type was supplied

application/json

get/integration-links

GET /v1/integration-links HTTP/1.1
Host: api.frill.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "idx": "idea_integration_link_abcd1234",
      "idea_idx": "idea_abcd1234",
      "type": "zendesk",
      "link_ref": "48221",
      "meta": {
        "url": "https://example.zendesk.com/agent/tickets/48221"
      },
      "created_at": "2026-03-04T11:22:03.000000Z",
      "updated_at": "2026-03-04T11:22:03.000000Z"
    }
  ],
  "pagination": {
    "total": 4300,
    "count": 100,
    "hasNextPage": true,
    "startCursor": "WyIyMDI2LTAzLTA0VDExOjIyOjAzLjAwMDAwMFoiLDFd",
    "endCursor": "WyIyMDI2LTAzLTA0VDExOjIyOjAzLjAwMDAwMFoiLDJd"
  },
  "meta": []
}