---
title: "Campaigns in a connected tool"
method: GET
path: "/api/v1/integrations/{integration_id}/campaigns"
tags: ["Integrations"]
---

# Campaigns in a connected tool

`GET /api/v1/integrations/{integration_id}/campaigns`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/integrations/{integration_id}/campaigns`
- Auth: HTTP bearer

The campaigns in your account of that tool, so you can pick where people go. Archived campaigns are left out. Use the id as target_campaign_id when you send.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Reads only | `argorant:read_counts` |

## Path parameters

- `integration_id` integer, required

## Headers

- `X-Request-Id` string

## Response `200`

OK

- object
  - `integration_id` string
  - `tool` string
  - `campaigns` object[]
    - `id` string
    - `name` string
    - `status` string

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:read_counts.
- `404`: 404 Not found. `not_found` when the item does not exist in your workspace.
- `409`: 409 Conflict. `unsupported_tool` when the tool has no campaigns to send people to; `tool_key_rejected` when the tool did not accept the saved key.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

[API](https://skmtc.dev/argorant/apis/argorant-api.md) · [All operations](https://skmtc.dev/argorant/apis/argorant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/argorant/apis/argorant-api/revisions/4bc28c0085b6?raw)