Mailings

Show mailing with provided ID

Changed on

Returns the mailing that matches the given ID.

get/api/v2/mailings/{id}

Request

  • Base URL
    https://yournation.nationbuilder.com
  • Auth
    HTTP bearer

Response

The requested mailing.

metaobject

Non-standard information about the document. Empty unless the endpoint has metadata to convey.

Example response

{
  "data": {
    "id": "1",
    "type": "mailings",
    "attributes": {
      "broadcaster_id": "1",
      "canceled_at": "2019-10-26T10:00:00-04:00",
      "created_at": "2019-10-26T10:00:00-04:00",
      "custom_list_id": "1",
      "description": "Welcome EMail",
      "from": "Broadcaster Name",
      "name": "Welcome Email",
      "preheader": "You signed up!",
      "published_at": "2019-10-26T10:00:00-04:00",
      "queued_at": "2019-10-26T10:00:00-04:00",
      "send_at": "2019-10-26T10:00:00-04:00",
      "slug": "acme",
      "subject": "Welcome to our community",
      "tag_list": "new-signups",
      "updated_at": "2019-10-26T10:00:00-04:00"
    }
  },
  "included": [
    {
      "id": "1"
    }
  ]
}

Changes

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • info

      added the new optional query request parameter extra_fields[mailings] to all path's operations

    • info

      added subschema #2 to the response body allOf list for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status