Get a campaign

Retrieve a single campaign by ID.

GET /v1/campaigns/{campaignId}

Get a campaign

cURL

curl --request GET \
  --url https://app.loops.so/api/v1/campaigns/{campaignId} \
  --header 'Authorization: Bearer <token>'

Response

{
  "success": true,
  "campaignId": "cmp_01hxyz",
  "name": "Spring announcement",
  "status": "Draft",
  "createdAt": "2026-03-28T15:00:00.000Z",
  "updatedAt": "2026-03-28T15:10:00.000Z",
  "emailMessageId": "em_01hxyz"
}

Content API endpoints are currently in an open alpha and are subject to change.

Request

Path parameters

campaignId · string · required

The ID of the campaign.

Response

Success

success · boolean · required

campaignId · string · required

The campaign ID.

name · string · required

The campaign name.

status · string · required

The campaign status.

createdAt · string · required

ISO 8601 timestamp for when the campaign was created.

updatedAt · string · required

ISO 8601 timestamp for when the campaign was last updated.

emailMessageId · nullable string · required

The associated email message ID.

Error

A 400 Bad Request is returned if campaignId is invalid.

A 404 Not Found is returned if the campaign does not exist.

If the API key is invalid (or content API is not enabled for your team), a 401 Unauthorized is returned.

success · boolean · required

message · string · required

An error message describing what went wrong.

Response

{
  "success": true,
  "campaignId": "cmp_01hxyz",
  "name": "Spring announcement",
  "status": "Draft",
  "createdAt": "2026-03-28T15:00:00.000Z",
  "updatedAt": "2026-03-28T15:10:00.000Z",
  "emailMessageId": "em_01hxyz"
}