{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/email-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Bulk contact management","siteUrl":"https://dev.mailjet.com/","projectTitle":"Mailjet Developer Documentation","description":"Bulk-manage Mailjet contacts with addforce, addnoforce, remove, and unsub actions to import, clear, or resubscribe contacts across lists in a single API call.","image":"https://dev.mailjet.com/og-image.png","lang":"en-US","keywords":["Mailjet API","Email API","Content API","SMTP Relay","transactional email","email delivery","Send API","email templates","developer documentation"],"meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Mailjet Developer Documentation"},{"name":"twitter:card","content":"summary_large_image"},{"name":"robots","content":"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1"},{"name":"googlebot","content":"index, follow, max-snippet:-1, max-image-preview:large"}],"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://dev.mailjet.com/#organization","name":"Mailjet","alternateName":"Sinch Mailjet","url":"https://www.mailjet.com","logo":"https://assets.mailjet.com/lib/images/mailjetLogo/mj_logo_with_text_color.png","parentOrganization":{"@type":"Organization","name":"Sinch","url":"https://www.sinch.com"}},{"@type":"WebSite","@id":"https://dev.mailjet.com/#website","name":"Mailjet Developer Documentation","description":"Official developer documentation for the Mailjet Email API, Content API and SMTP Relay.","url":"https://dev.mailjet.com/","inLanguage":"en-US","publisher":{"@id":"https://dev.mailjet.com/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://dev.mailjet.com/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]},"llmstxt":{"hide":false,"title":"Mailjet Developer Documentation","description":"Developer documentation for the Mailjet Email API, Content API and SMTP Relay - guides, API references and code samples for sending, templating and tracking email at scale.","details":{"content":"Mailjet (part of Sinch) provides APIs for sending and managing email.\n\nThis documentation covers four main areas:\n\n- **Email API** - the Send API (v3 and v3.1) for transactional and marketing email,\n  plus contact management, segmentation, campaigns, statistics, webhooks, the Parse API\n  and the Mailjet Templating Language.\n- **Content API** - programmatic management of email templates, template contents,\n  images, labels and authentication tokens (v1).\n- **SMTP Relay** - sending through Mailjet's SMTP servers, including custom headers.\n- **API Reference** - the complete, generated reference for every endpoint, built directly\n  from the OpenAPI specifications.\n\nBase URL for all REST APIs: `https://api.mailjet.com`.\nAuthentication uses HTTP Basic auth with an API key and secret key.\n\n## Machine-readable entry points\n\nPrefer these when you need the API surface in as few requests as possible:\n\n- `/openapi/openapi-mailjet.md` - the **complete** Email API reference (every endpoint,\n  grouped by resource) as a single Markdown document.\n- `/openapi/openapi-passport.md` - the **complete** Content API reference as a single\n  Markdown document.\n- `/_bundle/openapi/openapi-mailjet.yaml` - the raw, fully bundled OpenAPI 3 description\n  of the Email API.\n- `/_bundle/openapi/openapi-passport.yaml` - the raw, fully bundled OpenAPI 3 description\n  of the Content API.\n- `/sitemap.xml` - every indexable URL on this site.\n\nEvery page on this site is also available as clean Markdown by appending `.md` to its URL."},"sections":[{"title":"Email API","description":"Sending, contacts, campaigns, statistics, webhooks and templating.","includeFiles":["docs/email-api/**/*.md"],"excludeFiles":[]},{"title":"Content API","description":"Manage templates, template contents, images, labels and tokens.","includeFiles":["docs/content-api/**/*.md","docs/content-api.md"],"excludeFiles":[]},{"title":"SMTP Relay","description":"Send email through Mailjet's SMTP servers.","includeFiles":["docs/smtp-relay/**/*.md"],"excludeFiles":[]},{"title":"API Reference","description":"Complete generated reference for every Mailjet API endpoint.","includeFiles":["openapi/openapi-mailjet.yaml","openapi/openapi-passport.yaml","docs/api-reference/**/*.md"],"excludeFiles":[]},{"title":"Migrating from Mandrill","description":"Guides for switching from Mandrill to Mailjet.","includeFiles":["docs/mandrill/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"bulk-contact-management","__idx":0},"children":["Bulk contact management"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The bulk contact management resources help you manage the status of one or more contacts in relation to a single or multiple contact lists with a single call. The most common use cases for these resources are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Quickly importing the contact base from your Application or CRM into your Mailjet account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Clearing your contact lists by unsubscribing or removing contacts from them in regular intervals."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-methods","__idx":1},"children":["Available methods"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The available methods are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Manage the subscription status of a single contact to multiple contact lists"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Manage the subscription status of multiple contacts to a single contact list"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Manage the subscription status of multiple contacts to multiple contact lists"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Manage the link of multiple contacts to a list via a CSV upload"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choosing-an-action","__idx":2},"children":["Choosing an action"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using these resources, you always need to select an action to be performed:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addforce"]}," : Add the contacts to the list and subscribe all of them. If the contact is already present in the list as unsubscribed, it will be forcibly subscribed once again."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addnoforce"]}," : Add the contacts to the list and subscribe them to it. If the contact is already present, it will retain its subscription status, i.e. if a contact is part of the list, but unsubscribed, it will not be forcibly subscribed again."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["remove"]}," : Remove the contacts from the list"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unsub"]}," : Unsubscribe the contacts from the list"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"adding-contact-properties","__idx":3},"children":["Adding contact properties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to managing contacts, all of the methods covered in this guide allow you to include contact properties in your payload, thus helping you easily save relevant contact data in Mailjet. The values of these properties can later be used to personalize your emails, or to focus your campaigns on specific segments of your customer base."]}]},"headings":[{"value":"Bulk contact management","id":"bulk-contact-management","depth":1},{"value":"Available methods","id":"available-methods","depth":2},{"value":"Choosing an action","id":"choosing-an-action","depth":2},{"value":"Adding contact properties","id":"adding-contact-properties","depth":2}],"frontmatter":{"title":"Mailjet Send Contact Management","seo":{"description":"Bulk-manage Mailjet contacts with addforce, addnoforce, remove, and unsub actions to import, clear, or resubscribe contacts across lists in a single API call.","title":"Bulk contact management"}},"lastModified":"2026-08-26T10:53:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/email-api/contact-management/bulk-contact","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}