List Campaigns
GET/print-mail/v1/campaigns
Retrieve a list of campaigns.
Returns a paginated list of campaigns associated with the authenticated organization, filterable by various parameters.
Query Parameters
search: optional string
You can supply any string to help narrow down the list of resources. For example, if you pass "New York" (quoted), it will return resources that have that string present somewhere in their response. Alternatively, you can supply a structured search query. See the documentation on StructuredSearchQuery for more details.
List Campaigns
curl https://api.postgrid.com/print-mail/v1/campaigns \
-H "X-API-Key: $POSTGRID_PRINT_MAIL_API_KEY"{
"data": [
{
"id": "campaign_sqF12lZ1VlBb",
"createdAt": "2019-12-27T18:11:19.117Z",
"createdCount": 0,
"live": true,
"mailingList": "mailingList",
"status": "drafting",
"updatedAt": "2019-12-27T18:11:19.117Z",
"cheque": {
"bankAccount": "bankAccount",
"currencyCode": "CAD",
"description": "description",
"envelope": "envelope",
"letterSettings": {
"color": true
},
"letterTemplate": "letterTemplate",
"letterUploadedPDF": "https://example.com",
"logo": "https://example.com",
"mailingClass": "first_class",
"memo": "memo",
"mergeVariables": {
"foo": "bar"
},
"message": "message",
"metadata": {
"foo": "string"
},
"returnEnvelope": "returnEnvelope",
"size": "us_letter"
},
"defaultSenderContact": "defaultSenderContact",
"description": "description",
"errors": [
{
"message": "message",
"type": "processing_error"
}
],
"letter": {
"addressPlacement": "top_first_page",
"attachedPDF": {
"file": "https://example.com",
"placement": "before_template"
},
"color": true,
"description": "description",
"doubleSided": true,
"envelope": "envelope",
"envelopeType": "standard_double_window",
"mailingClass": "first_class",
"mergeVariables": {
"foo": "bar"
},
"metadata": {
"foo": "string"
},
"paper": "standard",
"perforatedPage": 1,
"returnEnvelope": "returnEnvelope",
"size": "us_letter",
"template": "template",
"uploadedPDF": "https://example.com"
},
"metadata": {
"foo": "bar"
},
"orderPreviewURL": "https://example.com",
"postcard": {
"backTemplate": "backTemplate",
"description": "description",
"frontTemplate": "frontTemplate",
"mailingClass": "first_class",
"mergeVariables": {
"foo": "bar"
},
"metadata": {
"foo": "string"
},
"paper": "standard",
"size": "6x4",
"uploadedPDF": "https://example.com"
},
"reportURL": "https://example.com",
"selfMailer": {
"description": "description",
"insideTemplate": "insideTemplate",
"mailingClass": "first_class",
"mergeVariables": {
"foo": "bar"
},
"metadata": {
"foo": "string"
},
"outsideTemplate": "outsideTemplate",
"size": "8.5x11_bifold",
"uploadedPDF": "https://example.com"
},
"sendDate": "2019-12-27T18:11:19.117Z",
"snapPack": {
"description": "description",
"insideTemplate": "insideTemplate",
"mailingClass": "first_class",
"mergeVariables": {
"foo": "bar"
},
"metadata": {
"foo": "string"
},
"outsideTemplate": "outsideTemplate",
"size": "8.5x11_bifold_v",
"uploadedPDF": "https://example.com"
}
}
],
"limit": 0,
"object": "list",
"skip": 0,
"totalCount": 0
}Returns Examples
{
"data": [
{
"id": "campaign_sqF12lZ1VlBb",
"createdAt": "2019-12-27T18:11:19.117Z",
"createdCount": 0,
"live": true,
"mailingList": "mailingList",
"status": "drafting",
"updatedAt": "2019-12-27T18:11:19.117Z",
"cheque": {
"bankAccount": "bankAccount",
"currencyCode": "CAD",
"description": "description",
"envelope": "envelope",
"letterSettings": {
"color": true
},
"letterTemplate": "letterTemplate",
"letterUploadedPDF": "https://example.com",
"logo": "https://example.com",
"mailingClass": "first_class",
"memo": "memo",
"mergeVariables": {
"foo": "bar"
},
"message": "message",
"metadata": {
"foo": "string"
},
"returnEnvelope": "returnEnvelope",
"size": "us_letter"
},
"defaultSenderContact": "defaultSenderContact",
"description": "description",
"errors": [
{
"message": "message",
"type": "processing_error"
}
],
"letter": {
"addressPlacement": "top_first_page",
"attachedPDF": {
"file": "https://example.com",
"placement": "before_template"
},
"color": true,
"description": "description",
"doubleSided": true,
"envelope": "envelope",
"envelopeType": "standard_double_window",
"mailingClass": "first_class",
"mergeVariables": {
"foo": "bar"
},
"metadata": {
"foo": "string"
},
"paper": "standard",
"perforatedPage": 1,
"returnEnvelope": "returnEnvelope",
"size": "us_letter",
"template": "template",
"uploadedPDF": "https://example.com"
},
"metadata": {
"foo": "bar"
},
"orderPreviewURL": "https://example.com",
"postcard": {
"backTemplate": "backTemplate",
"description": "description",
"frontTemplate": "frontTemplate",
"mailingClass": "first_class",
"mergeVariables": {
"foo": "bar"
},
"metadata": {
"foo": "string"
},
"paper": "standard",
"size": "6x4",
"uploadedPDF": "https://example.com"
},
"reportURL": "https://example.com",
"selfMailer": {
"description": "description",
"insideTemplate": "insideTemplate",
"mailingClass": "first_class",
"mergeVariables": {
"foo": "bar"
},
"metadata": {
"foo": "string"
},
"outsideTemplate": "outsideTemplate",
"size": "8.5x11_bifold",
"uploadedPDF": "https://example.com"
},
"sendDate": "2019-12-27T18:11:19.117Z",
"snapPack": {
"description": "description",
"insideTemplate": "insideTemplate",
"mailingClass": "first_class",
"mergeVariables": {
"foo": "bar"
},
"metadata": {
"foo": "string"
},
"outsideTemplate": "outsideTemplate",
"size": "8.5x11_bifold_v",
"uploadedPDF": "https://example.com"
}
}
],
"limit": 0,
"object": "list",
"skip": 0,
"totalCount": 0
}