Omnisend Automation

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

ranbot-ai/awesome-skills·0installs6starsProductivity & Planning

SKILL.md

Full skill instructions

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	`m` or `f`
`birthdate`	string	No	Format: `YYYY-MM-DD`
`country`	string	No	Full country name
`countryCode`	string	No	ISO 3166-1 alpha-2 code (e.g., `US`)
`city`	string	No	City name
`address`	string	No	Street address
`postalCode`	string	No	ZIP/postal code

2. List Contacts with Pagination

Retrieve contacts in batches with optional filters for email, phone, status, segment, or tag.

Tool: OMNISEND_LIST_CONTACTS

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`)

3. Get Contact Details

Retrieve the full profile for a single contact when you already have their contact ID.

Tool: OMNISEND_GET_CONTACT

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

4. Update an Existing Contact

Patch specific fields on a contact by ID without overwriting the entire record.

Tool: OMNISEND_UPDATE_CONTACT

Requires the contactId and the fields to update. Retrieve the contact ID first via OMNISEND_LIST_CONTACTS or OMNISEND_GET_CONTACT.

5. Bulk Batch Operations

Process many records asynchronously in a single call -- contacts, products, orders, events, or categories.

Tool: OMNISEND_CREATE_BATCH

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`

Use batch operations to avoid rate limits when processing large data sets.

Known Pitfalls

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

Quick Reference

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

Powered by Composio

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/ranbot-ai/awesome-skills --skill omnisend-automation

View on GitHub

skills/omnisend-automation/SKILL.md

More Productivity & Planning skills

View all

Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K

View

Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K

View

Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K

View

Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K

View

Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K

View

Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K

View

Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K

View

Productivity & Planning

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K

View