# Campayn

Campayn is an email marketing platform that allows users to create, send, and manage email campaigns.

- **Category:** email newsletters
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 14
- **Triggers:** 0
- **Slug:** `CAMPAYN`
- **Version:** 20260422_01

## Tools

### Create Contact

**Slug:** `CAMPAYN_CREATE_CONTACT`

Tool to create a new contact in a specific list. Use when you need to add a contact after gathering details.

### Delete Contact

**Slug:** `CAMPAYN_DELETE_CONTACT`

Tool to delete a specific contact. Use when you need to remove a contact permanently after confirming it should be deleted. Example: "Delete contact 123".

### Delete List

**Slug:** `CAMPAYN_DELETE_LIST`

Tool to delete a specific contact list. Use when cleaning up unused lists after confirming they are no longer needed. Example: "Delete list 123".

### Delete webform

**Slug:** `CAMPAYN_DELETE_WEBFORM`

Delete a specific webform from a contact list. Use this to permanently remove a webform that is no longer needed. Requires both the list_id and webform_id - use Get Webforms action first to find these values. Note: The API returns success even for non-existent webform IDs (idempotent delete behavior).

### Get Contact

**Slug:** `CAMPAYN_GET_CONTACT`

Tool to retrieve a specific contact by ID. Use when you need to fetch full contact details after confirming the contact ID.

### Get Contacts

**Slug:** `CAMPAYN_GET_CONTACTS`

Retrieves all contacts from a specific contact list in Campayn. Returns contact details including email, name, address, and confirmation status. Use 'Get Lists' action first to obtain the list_id. Supports optional filtering by contact name/email/company.

### Get Lists

**Slug:** `CAMPAYN_GET_LISTS`

Tool to retrieve all contact lists. Use when you need to fetch available lists before performing list-specific actions. Example prompt: "List all my contact lists".

### Get Message Statistics

**Slug:** `CAMPAYN_GET_MESSAGE`

Tool to retrieve engagement statistics for a specific email message by ID. Returns views, positive responses (clicks), and negative responses (unsubscribes/bounces). Use GET_MESSAGES first to get the list of available message IDs.

### Get Messages

**Slug:** `CAMPAYN_GET_MESSAGES`

Tool to retrieve all email messages. Use when you need to list all messages visible to the authenticated user.

### Get Reports

**Slug:** `CAMPAYN_GET_REPORTS`

Tool to retrieve report URLs and metadata for sent and scheduled emails. Use when you need to fetch email delivery data, optionally filtered by a date range (Unix timestamp in seconds, UTC). Note: scheduled emails will have report_url set to null.

### Get Webform

**Slug:** `CAMPAYN_GET_WEBFORM`

Tool to retrieve details of a specific webform by ID. Use after confirming the webform ID when you need to fetch form details like title, type, HTML, and signup count. Example: "Get webform 1550".

### Get Webforms

**Slug:** `CAMPAYN_GET_WEBFORMS`

Tool to retrieve all webforms for a specific contact list. Use when you need to list forms after confirming the list ID. Example prompt: "List all webforms in list 123".

### Unsubscribe Contact

**Slug:** `CAMPAYN_UNSUBSCRIBE_CONTACT`

Tool to unsubscribe contacts from a list by contact id or email address. Use when you need to remove contacts from a mailing list. If id is provided, only that specific contact will be unsubscribed. If email is provided, all contacts on that list with that email will be unsubscribed.

### Update List

**Slug:** `CAMPAYN_UPDATE_LIST`

Tool to update a contact list. Use after confirming list ID and desired changes. Example: Update list 123 name to 'Newsletter Subscribers'.
