Cordial

Cordial Contacts API

The contacts API from Cordial — 17 operation(s) for contacts.

GitHub OpenAPI
Business capability
Customer Data Management BC-420.10

Operations 27

POST /v1/contacts/{primary_key}/downloadprofile Export Contact Profile #
POST /v1/contacts Add a new contact to the system #
GET /v1/contacts Get contacts #
PUT /v1/contacts/{primary_key} Update an existing contact #
GET /v1/contacts/{primary_key} Get a single contact #
DELETE /v1/contacts/{primary_key} Delete a single contact #
PUT /v1/contacts/{primary_key}/unsubscribe/{channel} Unsubscribe contact by primary Key with channel #
POST /v1/contacts/{primary_key}/cart Add cart object to contact #
PUT /v1/contacts/{primary_key}/cart Update cart #
DELETE /v1/contacts/{primary_key}/cart Remove cart object from contact #
POST /v1/contacts/{primary_key}/cartitems Add product to cart #
DELETE /v1/contacts/{primary_key}/cartitems/{productID} Remove product from cart #
DELETE /v1/contacts/{primary_key}/cartitems/{productID}/{qty} Remove product from cart by Qty #
POST /v2/contacts Add a contact #
GET /v2/contacts Get contacts #
PUT /v2/contacts/{primary_key} Update a contact #
GET /v2/contacts/{primary_key} Get a single contact #
DELETE /v2/contacts/{primary_key} Delete a single contact #
PUT /v2/contacts/{primary_key}/unsubscribe/{channel} Unsubscribe a contact #
POST /v2/contacts/merge Merges two contacts #
POST /v2/contacts/split Splits a contact #
POST /v2/contacts/{primary_key}/cart Add contact cart object #
PUT /v2/contacts/{primary_key}/cart Update contact cart object #
DELETE /v2/contacts/{primary_key}/cart Remove contact cart object #
POST /v2/contacts/{primary_key}/cartitems Add product to cart #
DELETE /v2/contacts/{primary_key}/cartitems/{productID}/{qty}/{sku} Remove product from cart in quantities by product ID and, optionally, SKU #
POST /v2/contacts/{primary_key}/downloadprofile Download contact profile #

Documentation

📖
Documentation
https://support.cordial.com/hc/en-us/categories/12092749097741-Developer-resources
📖
APIReference
https://developers.cordial.com/api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cordial/refs/heads/main/openapi/cordial-contacts-api-openapi.yml

Other Resources

🔗
Console
https://api.cordial.io/docs/v2/
🔗
Console
https://api.cordial.io/docs/v1/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cordial-contacts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cordial-contacts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Cordial Contacts API
  termsOfService: https://cordial.zendesk.com
  version: '1.0'
  description: 'Operations tagged contacts across 2 of this provider''s published API definitions: cordial-v1-openapi-original.json, cordial-v2-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.cordial.io/
tags:


# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cordial/refs/heads/main/openapi/cordial-contacts-api-openapi.yml