managing-contacts

Manage marketing contacts and bulk imports via the Mailtrap Contacts API.

7|1|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/mailtrap/mailtrap-skills --skill managing-contacts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: managing-contacts
Source: https://github.com/mailtrap/mailtrap-skills/tree/main/skills/managing-contacts
Command: npx skills add https://github.com/mailtrap/mailtrap-skills --skill managing-contacts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill centralizes programmatic management of marketing contacts to avoid manual CSV edits, inconsistent CRM syncs, and audience drift that harms campaign targeting and deliverability.

Core Features & Use Cases

  • Create & Update Contacts: Upsert individual contacts with list membership and custom fields via the Contacts API.
  • Bulk Import & Sync: Submit large asynchronous imports (up to 50,000 contacts) and poll import status for CRM or data warehouse syncs.
  • Segmentation & Events: Build dynamic segments, manage contact lists, and post custom events to drive automations and campaign audiences.
  • Use Case: Nightly sync from a CRM to Mailtrap using bulk imports, mapping custom fields and triggering events for automation workflows.

Quick Start

Use the managing-contacts skill to bulk import a CSV of leads into my Mailtrap account, map custom fields, and create a segment for a campaign.

Frequently Asked Questions about managing-contacts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bulk import contacts into Mailtrap from a CRM sync?

Mailtrap bulk imports accept up to 50,000 contacts asynchronously via the Contacts API, allowing you to map custom fields and poll import status for CRM syncs without manual CSV edits.

What are the API rate limits for managing Mailtrap contacts?

Mailtrap contact management APIs enforce typical rate limits of 200 requests per 60 seconds, so batch your contact creation, updates, and custom event payloads to avoid throttling during audience syncs.

Can I create dynamic segments and custom events for Mailtrap contacts?

Yes, the Mailtrap Contacts API allows you to build dynamic segments, manage contact lists, and post custom events to drive automations and campaign audiences using account-scoped endpoints.

How do I upsert individual contacts with custom fields in Mailtrap?

You can upsert individual Mailtrap contacts with list membership and custom fields directly via the Contacts API, ensuring audience targeting data stays current without manual CSV edits.

Do I need account-scoped endpoints to sync contacts from a data warehouse to Mailtrap?

Yes, syncing contacts from a data warehouse to Mailtrap requires account_id-scoped Contacts API endpoints to securely manage bulk imports, custom field mapping, and automation event triggers.