How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Omnisend

Omnisend Contacts API

The Contacts API from Omnisend — 7 operation(s) for contacts. Version 2026-03-15, harvested from Omnisend's published contract.

Documentation Provider Profile APIs.io OpenAPI GitHub

Omnisend Contacts API is one of 16 APIs that Omnisend publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Contacts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a JSON-LD context, and 2 JSON Schemas.

This API exposes 7 operations across 3 paths, and defines 19 schemas. It is described by OpenAPI 3.2.0, at version 2026.

Requests are made against a single base URL, https://api.omnisend.com/api.

7 operations 3 paths 19 schemas 1 DELETE2 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026
Base URL
https://api.omnisend.com/api
Authentication
API Key, OAuth 2.0
Resource Areas
1

Authentication & Security 2

Omnisend Contacts API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (ApiKeyAuth). It supports OAuth 2.0 (Bearer) using the clientCredentials flow, exposing 2 scopes.

  • ApiKeyAuth — API Key authentication. Value format: 'Omnisend-API-Key {api-key}'

Paths & Operations 7

Across 3 paths, the API surfaces 7 operations — 1 DELETE, 2 GET, 2 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Contacts 7
GET
/contacts
List contacts
getContacts 12 params → 200400401403410429500
PATCH
/contacts
Update contact by email
patchContacts 2 params body → 200400401403404409410429
POST
/contacts
Create or update existing contact
postContacts 1 param body → 200201400401403410429500
GET
/contacts/{id}
Get contact
getContactsById 2 params → 200400401403404410429500
PATCH
/contacts/{id}
Update contact by ID
patchContactsById 2 params body → 200400401403404409410429
DELETE
/contacts/tags
Batch remove tags
deleteContactsTags 1 param body → 202400401403410429500
POST
/contacts/tags
Batch add tags
postContactsTags 1 param body → 202400401403410429500

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are ContactResponse (23 properties), ContactRequest (14 properties), ContactIdentifierRequest (6 properties), RateLimitProblem (6 properties). Each schema is shown below with its type and property counts.

CursorsResponse
object
Cursor pointers for paginating forward and backward through results
2 properties
ContactStatus
object
Contact status per channel.
3 properties
ContactConsentRequest
object
Consent record.
4 properties
ContactRequest
object
Payload for creating or updating a contact.
14 properties
AddTagsRequest
object
Payload for batch adding tags to contacts.
5 properties 1 required
ListContactsResponse
object
Paginated list of contacts.
2 properties
Channel
object
Channel subscription status.
2 properties
PagingResponse
object
Cursor-based pagination metadata
3 properties
ContactResponse
object
Contact resource representation.
23 properties
Consent
object
Consent record for a contact channel.
5 properties
ContactIdentifierRequest
object
A unique contact identifier (email or phone). For phone: provide the full number with country code prefix in E.164 format (e.g. +1234567890).
6 properties 2 required
OptIn
object
Contact opt-in record.
2 properties
Identifier
object
Unique contact identifier (email or phone).
3 properties
FieldError
object
A single field validation failure within a validation error response.
3 properties
Problem
object
Standard error response returned by all API endpoints on failure.
5 properties
RemoveTagsRequest
object
Payload for batch removing tags from contacts.
5 properties 1 required
ContactChannelRequest
object
Channel subscription details.
2 properties 1 required
ValidationProblem
object
Error response returned when the request contains invalid input. The errors array lists every field that failed validation.
6 properties
RateLimitProblem
object
Error response returned when the rate limit is exceeded. Use the retryAfter value to know when it is safe to retry the request.
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

omnisend-contacts-api-openapi.yml Raw ↑

Other APIs Omnisend publishes across the network.

Omnisend Brands API
AE Profile APIs.io
Omnisend Campaigns API
AE Profile APIs.io
Omnisend Events API
AE Profile APIs.io
Omnisend Images API
AE Profile APIs.io
Omnisend Products API
AE Profile APIs.io
Omnisend Segments API
AE Profile APIs.io
Omnisend Automations API
AE Profile APIs.io
Omnisend Event Metadata API
AE Profile APIs.io
Omnisend Batch API
AE Profile APIs.io
Omnisend Email Content API
AE Profile APIs.io
Omnisend Email Templates API
AE Profile APIs.io
Omnisend Email Universal Layouts API
AE Profile APIs.io
#Contacts
← Back to O APIs
API Details
ID
omnisend:omnisend-contacts-api
Base URL
https://api.omnisend.com/api
Docs
https://api-docs.omnisend.com/reference/overview
Provider
Omnisend
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=omnisend-contacts-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/omnisend-contacts-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Omnisend Contacts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.