---
title: "Get an integration"
method: GET
path: "/v1/sites/{site_id}/integrations/{integration_id}"
tags: ["Integrations"]
---

# Get an integration

`GET /v1/sites/{site_id}/integrations/{integration_id}`

## Request

- Base URL: `https://api.getsitecontrol.com`
- URL: `https://api.getsitecontrol.com/v1/sites/{site_id}/integrations/{integration_id}`
- Auth: HTTP bearer

One integration with everything `list_integrations` gives except `failures`, plus its saved setup: the delay before sending, double opt-in, and what is sent where (`mapping`). Header values, fixed values and service credentials are not shown.

The setup is as saved now: not unsaved changes in the editor, and not what an older delivery was built from. A setting seen here is a thing to check, never the proven cause of a past failure. A deleted integration is still returned, with `is_deleted: true`.

## Path parameters

- `site_id` integer, required
- `integration_id` string, required: Integration id from `list_integrations`, such as `webhook:12`

## Response `200`

Successful Response

- IntegrationCard
  - `id` string, required: Integration id, the kind and a number, such as `webhook:12`
  - `kind` 'service' | 'webhook' | 'zapier', required: service: a connected service such as Mailchimp or HubSpot; webhook: a request to a URL the site set up; zapier: a URL that Zapier or a similar automation platform subscribed.
  - `service` string, nullable: Connected service, such as `mailchimp`; null for the other kinds
  - `name` string, nullable: Name of the integration; null for webhook and zapier
  - `target_name` string, nullable: List, audience or other place in the service the data goes to; null for webhook and zapier
  - `url` string, nullable: Saved destination URL of a webhook or zapier; null for a service
  - `format` 'json' | 'form', nullable: Body format of a webhook: JSON or form-encoded; null otherwise
  - `widget` IntegrationWidget, required
    - `id` integer, required: Widget id, as in `list_widgets`
    - `name` string, nullable
  - `is_active` boolean, required: true: switched on now; false: switched off now. Says nothing about when it was switched
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `is_deleted` boolean, required: true: deleted; its id and delivery history stay readable
  - `delay_seconds` integer, nullable: Seconds a delivery waits after it is created before it is first tried
  - `double_opt_in` boolean, nullable: true: the service asks the subscriber to confirm by email first; null when not set for this integration
  - `mapping` MappingSummary, required
    - `is_available` boolean, required: false: the saved mapping could not be read, and the other fields say nothing about it
    - `fields` MappingField[]: Fields filled from the response, at most 40
      - `source` string, required: Where the value comes from, such as `$form.<field>` for a form field or `$system.<name>` for data recorded with the response (its id, page, location)
      - `destination` string, required: Field it is sent to at the destination
    - `fields_total` integer: All mapping entries, of every type
    - `fields_omitted` integer: Mapping entries not listed in `fields`, the counted types included
    - `literal_fields` integer: Fields set to a fixed value; values not shown
    - `header_fields` integer: HTTP headers sent; values not shown
    - `condition_fields` integer: Conditions that decide whether to send at all
  - `last_succeeded_at` string, date-time, nullable: As in `list_integrations`: the last success ever; null when none

## Other responses

- `400`: Unsupported GSC-Version
- `401`: Missing or invalid API key or access token
- `403`: Access denied
- `404`: `integration_not_found`: no such integration on the site, or its widget is deleted
- `422`: Validation failed
- `429`: Rate limited
- `503`: `temporarily_unavailable`: the delivery records could not be read in time, or limits cannot be enforced; retry later

---

[API](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api.md) - [All operations](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/revisions/084fcad80e75?raw)