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

Cordial batch messages API

The batch messages API from Cordial — 18 operation(s) for batch messages.

Cordial batch messages API is one of 25 APIs that Cordial publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include batch messages. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 24 operations across 18 paths, and defines 26 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://api.cordial.io/.

24 operations 18 paths 26 schemas 2 DELETE7 GET2 POST13 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.cordial.io/v2
Authentication
HTTP Basic
Terms of Service
Resource Areas
1

Authentication & Security 1

Cordial batch messages API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth).

  • basicAuth — HTTP Basic Authentication. Works over HTTPS

Paths & Operations 24

Across 18 paths, the API surfaces 24 operations — 2 DELETE, 7 GET, 2 POST, 13 PUT. Each is listed below with its method, path, parameters, and response codes.

batch messages 24
POST
/v1/batchmessages
Create a batch message
addBatch body → 201422
GET
/v1/batchmessages
Get batch messages
getBatch 16 params → 201404
PUT
/v1/batchmessages/{id}
Update an existing message
updateBatch 1 param body → 201400
GET
/v1/batchmessages/{id}
GET single message by msID
getSingleBatch 1 param → 201404
DELETE
/v1/batchmessages/{id}
Delete a single contact
deleteSingleBatch 1 param → 201404
PUT
/v1/batchmessages/{id}/send
Send Manual Messagesend
sendSingleBatch 1 param → 201404400
PUT
/v1/batchmessages/{id}/sendtest
Send a test batch message
sendTestSingleBatch 1 param body → 201404
GET
/v1/batchmessages/{id}/renderedwip/{contactID}
Render preview of a batch message
renderPreviewSingleBatch 4 params → 201404
PUT
/v1/batchmessages/{id}/pause
Pause a batch message sending
pauseSingleBatch 1 param → 201404
PUT
/v1/batchmessages/{id}/cancel
Cancel a batch message sending
cancelSingleBatch 1 param → 201404
PUT
/v1/batchmessages/{id}/resume
Resume a batch message sending
resumeSingleBatch 1 param → 201404
POST
/v2/batchmessages
Create a batch message
addBatch body → 201422
GET
/v2/batchmessages
Get batch messages
getBatch 16 params → 201404
PUT
/v2/batchmessages/{id}
Update a batch message draft
updateBatch 1 param body → 201422404
GET
/v2/batchmessages/{id}
Get a single batch message
getSingleBatch 1 param → 201404
DELETE
/v2/batchmessages/{id}
Delete a batch message
deleteSingleBatch 1 param → 200404
PUT
/v2/batchmessages/{id}/send
Send or schedule a batch message
sendSingleBatch 1 param → 201422404
PUT
/v2/batchmessages/{id}/sendtest
Send a test batch message
sendTestSingleBatch 1 param body → 201422404
GET
/v2/batchmessages/{id}/experimentperformance
Get experiment performance for single batch message
geBatchExperimentPerformance 1 param → 200404
GET
/v2/batchmessages/{id}/renderedwip/{contactID}
Render preview of a batch message
renderPreviewSingleBatch 4 params → 201404422
PUT
/v2/batchmessages/{id}/pause
Pause batch message sending
pauseSingleBatch 1 param → 201404
PUT
/v2/batchmessages/{id}/cancel
Cancel batch message sending
cancelSingleBatch 1 param → 201404
PUT
/v2/batchmessages/{id}/resume
Resume batch message sending
resumeSingleBatch 1 param → 201404
PUT
/v2/batchmessages/{id}/unschedule
Unschedule a batch message
unscheduleBatch 1 param → 201404

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are MessageSendBatchPost_2 (17 properties), ExperimentStats (14 properties), MessageSendBatchPost (14 properties), MessageSendBatch_2 (12 properties). Each schema is shown below with its type and property counts.

MessageSendBatch_2
object
12 properties 2 required
BatchSendMessageError
object
3 properties 3 required
ExperimentStats
object
14 properties
MessageSendBatchPost_2
object
17 properties 2 required
BatchMessageError
object
3 properties 3 required
ExperimentVariants
object
2 properties 2 required
AlertConditions
object
2 properties 4 required
ExperimentsStats
object
5 properties 5 required
Tests
object
2 properties 2 required
BatchMessageCreated
object
2 properties 2 required
SuccessOperation
object
1 property 1 required
RecordNotFound
object
3 properties 2 required
MessageSendBatchPost
object
14 properties 2 required
MessageSendBatch
object
9 properties 2 required
MessageBatch
object
2 properties 2 required
SuccessRenderMessage
object
3 properties 1 required
AlertResponse
object
8 properties
BatchRenderMessageError
object
3 properties 3 required
HeadersBatch
object
4 properties 4 required
HeadersBatch_2
object
4 properties 4 required
RecipientsTestBatch_2
object
1 property 1 required
BatchSendTestMessageError
object
3 properties 3 required
ContentBatch_2
object
1 property 1 required
RecipientsTestBatch
object
1 property 1 required
ContentBatch
object
1 property 1 required
Tests_2
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cordial-batch-messages-api-openapi.yml Raw ↑

Other APIs Cordial publishes across the network.

Cordial MCP Server
Cordial account attributes API
Cordial account lists API
Cordial account monitor export API
Cordial Alerts API
Cordial analytics audiences API
Cordial analytics messages API
Cordial Audiencecount API
Cordial automation templates API
Cordial contact activities API
Cordial contact activity exports API
Cordial contact exports API
Where this information came from

This is an independent, third-party profile of Cordial batch messages 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.