mailtrap-managing-contacts
Helps your agent manage contacts in Mailtrap. It allows organizing lists, segments, and importing data for email campaigns.
What it does
This tool helps manage your marketing contact list. You can add, update, or import contacts, organize them into lists, and add extra information like name and company.
When to use it
- ✓When you need to add many contacts at once.
- ✓To organize your contacts into specific groups (lists).
- ✓To add custom information to each contact, like name or company.
Example of what to ask your AI
“Import 100 contacts from my CSV file to the 'VIP Customers' list and add the 'Company' field.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The tool connects to your Mailtrap account and uses commands to add, remove, or update information for your contacts. It can do this individually or in large batches.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill mailtrap-managing-contactsOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/mailtrap-managing-contacts/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Managing Mailtrap contacts
Overview
Before generating API request bodies: check the Contacts OpenAPI spec for current field names, required parameters, and nested structures.
Contacts are the marketing database: lists, segments, custom fields, and imports for campaign audiences and related workflows. The Contacts API automates create/update and can feed CRM or CDP sync (your code, or tools like Zapier, Make, n8n — see Import contacts).
Suppressions (hard bounces, spam complaints, unsubscribes on the sending side) live in the sending product and block delivery for those addresses on your streams. That is applied separately from marketing filters (segments, list membership, consent flags) that decide who is eligible for campaigns. For sending-side blocks, see Suppressions and mailtrap-sending-emails.
Related skills: mailtrap-sending-emails (live send paths).
When to use
- Programmatic contact management (create, update, bulk import)
- Sync with CRMs or data warehouses
- Contact list cleanup and CSV import
- Updating contacts with custom fields or firing custom events for automations
- Segments and custom fields for audience building
Authorization
All endpoints below need Authorization: Bearer $MAILTRAP_API_TOKEN and an $MAILTRAP_ACCOUNT_ID in the path. Resolve $MAILTRAP_ACCOUNT_ID from GET https://mailtrap.io/api/accounts, and store tokens in environment variables or a secrets manager.
Endpoints (replace placeholders)
| Action | Method | URL | Reference |
|---|---|---|---|
| Create / get / update / delete contact | various | https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts |
Contacts |
| Bulk import (async job) | POST |
https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/imports |
Bulk import |
| Contact lists | various | https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/lists |
Contact lists |
| Custom fields | various | https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/fields |
Contact fields |
| Custom events | POST |
https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/{contact_identifier}/events |
Contact events |
| Export contacts | various | https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/exports |
Export contacts |
- Rate limit (typical): 200 requests per 60 seconds per account — prefer bulk import for large loads.
- Bulk import limit: up to 50,000 contacts per import request (async job); poll import status with
GET .../contacts/imports/{import_id}. See Bulk import.
Examples (curl)
Single contact create (with custom fields)
curl -X POST "https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts" \
-H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
…
FAQ
What are 'lists' and 'custom fields'?
Lists are groups of contacts you create, like 'Newsletter' or 'Customers'. Custom fields are extra pieces of information you can add to each contact, such as 'First Name', 'Last Name', or 'Company'.
Can I import contacts from a file?
Yes, you can import contacts in bulk from a file, like a CSV, into your lists.
Does this tool send emails?
No, this tool only manages contacts. To send emails, you would need to use a different tool like 'mailtrap-sending-emails'.
Details
Original description by the author
Manage Mailtrap contacts, lists, segments, custom fields, imports, CRM syncs, and campaign audiences through the UI or API.
Popularity
- GitHub stars
- 48k
- Ranking position
- #3519
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
operator-approval-loop
Makes your agent manage message sending with human approval. It ensures important messages are reviewed before being sent.
affaan-m/ECC
discernment-nudge
Has your agent add follow-up questions after giving an important answer. It's useful for ensuring you think carefully about advice or plans before acting.
anthropics/skills
interview-me
Asks questions to understand exactly what you need. Ensures the agent grasps your real need before starting work.
addyosmani/agent-skills