Adding Labels to Your Campaigns

You can use labels to tag and find related campaigns in your project.

# Table of contents

# Managing your project's labels

Navigate to Settings > Project Settings.

Scroll down to the Manage Labels section.

From this page, you can:

• Add new labels
• Edit labels
• Delete labels

# Adding a label to a campaign

To add labels to a new campaign (or one that's already been created, but is still in the Draft or Ready state), navigate to the Setup step of the campaign creation process and edit the Labels field. (You can drag labels around in the input to reorder them.)

To add labels to a Finished or Running campaign, open the campaign. Under the campaign title at the top of the screen, click the attached labels (or Click to apply labels to campaign for campaigns without any labels) to make changes.

# Searching for campaigns by label

To find all the campaigns with a particular label, navigate to Messaging > Campaigns.

The labels attached to each campaign are shown under the names of your campaigns.

You can also filter your campaigns list by label.

Click Filters > Label and select some labels from the drop-down.

# Exporting campaign labels

You can use the GET /api/campaigns endpoint to fetch campaign metadata, including labels. This endpoint returns data like this:

{
  "campaigns": [
    {
      "id": 1611189,
      "createdAt": 1602627617382,
      "updatedAt": 1602627690330,
      "startAt": 1602627690330,
      "endedAt": 1602627690497,
      "name": "Fall sale",
      "templateId": 2225431,
      "messageMedium": "Email",
      "createdByUserId": "docs@iterable.com",
      "campaignState": "Finished",
      "listIds": [657633],
      "suppressionListIds": [],
      "sendSize": 23431,
      "labels": ["seasonal-sale"],
      "type": "Blast"
    }
  ]
}