Skip to content

Create a Mailing

POST /mailings

Creates a new Mailing based on an already existing and approved Mailing Template, which can be edited using the New Xperience Mailing Editor.

Request Parameters

Parameter Required In Description
mailingTemplateId yes query The ID of the approved Mailing Template based on which the new Mailing instance should be created

Payload Structure

Path Type Description Constraints
name String Sets the initial name of the Mailing
  • Must not be null
  • Must not be empty
  • Must contain at least one non-whitespace character
  • Length must not exceed 255 characters
subject String Optional: Sets the initial subject of the Mailing. If not set, the name of the Mailing will be used.
preheader String Optional: Sets the initial preheader of the Mailing

Response Structure

Path Type Description
id String The ID of the created Mailing instance
Name Description
inx:mailing-editor The link to open the New Xperience Mailing Editor for the Mailing

Basic Example

Request:

$ curl 'https://myka-1.my-api.inxmail.de/mailings?mailingTemplateId=e420c737-5378-4f4b-a79b-c55adba548db' -i -X POST \
    -H 'Authorization: Basic <base64Encoded user:password>' \
    -H 'Content-Type: application/hal+json' \
    -d '{
  "name" : "My first Mailing based on a Mailing Template"
}'

Response:

HTTP/1.1 201 Created
Content-Type: application/hal+json;charset=UTF-8
Content-Length: ...

{
    "id": "a7968193-10ca-49fb-b088-72aff812a205",
    "_links": {
        "self": {
            "href": "https://myka-1.my-api.inxmail.de/mailings/a7968193-10ca-49fb-b088-72aff812a205"
        },
        "inx:mailing-editor": {
            "href": "https://myka-1.my.inxmail.de/mrm/integrations/mailings/a7968193-10ca-49fb-b088-72aff812a205/edit"
        },
        "curies": [
            {
                "href": "https://apidocs.inxmail.com/nxp/rest/v1/relations/{rel}",
                "name": "inx",
                "templated": true
            }
        ]
    }
}