# campaign

Query

Return a single campaign by ID for the current workspace, or null if no such campaign exists here.

Available to agents as MCP tool `getCampaign` — see [Read tools](/api/v2/docs/mcp/read-tools#get-campaign).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `id` | `ID!` | Yes | — | UUID of the campaign to fetch. |

## Returns

Returns [`Campaign`](/api/v2/docs/types/campaign).

## Examples

### Get a campaign by ID

Read a campaign's type, external key, dates and current roster size.

```graphql
query CampaignDefault($id: ID!) {
  campaign(id: $id) {
    id
    name
    campaignType
    externalId
    dateStart
    dateEnd
    creatorsCount
  }
}
```

Variables:

```json
{
  "id": "422fac58-557c-5cd4-8986-84ac3db4b133"
}
```

Response — HTTP 200:

```json
{
  "data": {
    "campaign": {
      "id": "422fac58-557c-5cd4-8986-84ac3db4b133",
      "name": "Spring Launch",
      "campaignType": "CONTENT_CAPTURE",
      "externalId": null,
      "dateStart": null,
      "dateEnd": null,
      "creatorsCount": 0
    }
  }
}
```