Create Postcard

Creates a postcard in PostGrid Print & Mail.

POST

Query

Field selectionChoose which fields should be included in the response. Learn more

string

Comma-separated response fields to include.

Body

Arguments

stringrequired

The recipient contact ID or recipient payload.

stringrequired

The postcard size.

string

Inline HTML for the front of the postcard.

string

Inline HTML for the back of the postcard.

string

The template ID for the front of the postcard.

string

The template ID for the back of the postcard.

string

A two-page PDF source for the postcard.

string

The sender contact ID or sender payload.

object

Template merge variables for the postcard.

string

An optional description visible in the API and dashboard.

object

Custom metadata for this postcard.

date

Schedule the postcard for a future send date.

string

The mailing class for the postcard.

string

Paper stock settings for the postcard.

Try this request

Request

curl --request POST \
  --url "https://connect.mindcloud.co/v1/universal/postGridPrintMail/latest/actions/create-postcard" \
  --header "Authorization: Bearer $MINDCLOUD_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "connectionId": "$CONNECTION_ID",
  "to": "",
  "size": ""
}'

{
  "success": true,
  "data": [
    {
      "backHTML": "string",
      "cancellation": {},
      "carrierTracking": {},
      "createdAt": "2026-05-07T12:00:00.000Z",
      "description": "string",
      "frontHTML": "string",
      "id": "string",
      "live": true,
      "mailingClass": "string",
      "object": "string",
      "pageCount": 1,
      "paper": "string",
      "sendDate": "2026-05-07T12:00:00.000Z",
      "size": "string",
      "status": "string",
      "to": {},
      "updatedAt": "2026-05-07T12:00:00.000Z",
      "url": "https://example.com"
    }
  ],
  "meta": {}
}

Every app you connect,one REST pattern

Call any app with one REST pattern. MindCloud handles each provider's auth, request shape, and responses for you.

Learn what the Universal API is

One REST patternUse the same request structure across apps like Slack, HubSpot, Salesforce, and thousands more.

Managed connectionsSend a MindCloud connection ID instead of handling provider tokens, refresh logic, and credential storage yourself.

Action-level docsEach action page shows the exact endpoint, required arguments, optional controls, and response behavior for that app version.