Omnisend Automation

composio-community/awesome-codex-skillsMarketingAudit passedSnapshot d6b4e913ef68

Installs: 0

Summary

Automate ecommerce marketing workflows including contact management, bulk operations, and subscriber segmentation through Omnisend via Composio

SKILL.md

Omnisend Automation

Automate ecommerce marketing operations -- create and update contacts, manage subscriber lists with cursor pagination, run bulk batch operations, and segment audiences -- all orchestrated through the Composio MCP integration.

Toolkit docs: composio.dev/toolkits/omnisend

Setup

Connect your Omnisend account through the Composio MCP server at https://rube.app/mcp
The agent will prompt you with an authentication link if no active connection exists
Once connected, all OMNISEND_* tools become available for execution

Core Workflows

1. Create or Update a Contact

Upsert a contact by email identifier with subscription status, profile fields, and optional welcome message.

Tool: OMNISEND_CREATE_OR_UPDATE_CONTACT

Parameter	Type	Required	Description
`identifiers`	array	Yes	At least one identifier object with `id` (email), `type` (`email`), optional `channels.email.status` (`subscribed`, `nonSubscribed`, `unsubscribed`), and `sendWelcomeMessage` (boolean)
`firstName`	string	No	Contact's first name
`lastName`	string	No	Contact's last name
`gender`	string	No	or

m

f

Parameter	Type	Required	Description
`limit`	integer	No	Results per page (default: 100, max: 250)
`after`	string	No	Cursor for next page (base64-encoded ContactID)
`before`	string	No	Cursor for previous page
`email`	string	No	Filter by exact email address
`phone`	string	No	Filter by full phone number with country code
`status`	string	No	Filter by: `subscribed`, `nonSubscribed`, `unsubscribed`
`segmentID`	integer	No	Filter by segment ID
`tag`	string	No	Filter by tag (e.g., `VIP`)

Parameter	Type	Required	Description
`contactId`	string	Yes	Unique contact identifier (e.g., `60e7412b1234567890abcdef`)

Parameter	Type	Required	Description
`method`	string	Yes	`POST` or `PUT`
`endpoint`	string	Yes	Target: `contacts`, `orders`, `products`, `events`, `categories`
`items`	array	Yes	Array of payload objects for each operation
`eventID`	string	Conditional	Required when endpoint is `events`

Pitfall	Details
Identifier required	`OMNISEND_CREATE_OR_UPDATE_CONTACT` requires at least one identifier in the `identifiers` array -- only `email` type is supported
Cursor-based pagination	`OMNISEND_LIST_CONTACTS` uses base64-encoded `after`/`before` cursors, not page numbers -- follow cursors to avoid incomplete data
Contact ID resolution	`OMNISEND_UPDATE_CONTACT` requires a `contactId` -- always resolve it first via list or get operations
Batch method constraints	`OMNISEND_CREATE_BATCH` only accepts `POST` or `PUT` methods -- no `DELETE` or `PATCH`
Event ID dependency	When batching events, the `eventID` parameter is mandatory -- omitting it causes the batch to fail

Tool Slug	Purpose
`OMNISEND_CREATE_OR_UPDATE_CONTACT`	Create or upsert a contact by email
`OMNISEND_LIST_CONTACTS`	List contacts with filtering and cursor pagination
`OMNISEND_GET_CONTACT`	Get full profile for a single contact by ID
`OMNISEND_UPDATE_CONTACT`	Patch specific fields on an existing contact
`OMNISEND_CREATE_BATCH`	Bulk async operations for contacts, products, orders, events

Omnisend Automation

Summary

SKILL.md

Omnisend Automation

Setup

Core Workflows

1. Create or Update a Contact

2. List Contacts with Pagination

3. Get Contact Details

4. Update an Existing Contact

5. Bulk Batch Operations

Known Pitfalls

Quick Reference

Related skills