Creatives Library

List All

Changed on

List the creatives in your Creatives library, 24 per page: the default creative of each type first, then most recently updated. A creative pairs an image template with a message template; send one by passing its id as creative_id to any send or estimate endpoint.

get/creatives/

Request

  • Base URL: https://api.thanks.io/api/v2
  • URL: https://api.thanks.io/api/v2/creatives/
  • Auth: HTTP bearer

Query parameters

sub_account_idinteger

Filter results by Sub Account ID.

mailer_type'postcard' | 'postcard6x9' | 'postcard6x11' | 'letter' | 'windowlessletter' | 'notecard' | 'giftcard' | 'magnacard'

Only return creatives of this type. postcard is 4x6. Use the type you will send: a 6x9 postcard send takes a postcard6x9 creative.

complete_onlyboolean

Only return creatives with both sides present (letters need only a message). Only complete creatives can be sent. Pass 1 to turn the filter on.

searchstring

Only return creatives whose name contains this text.

include_hiddenboolean

Include creatives hidden from the library. Pass 1 to turn it on.

pageinteger

Page number.

Response

OK

Example response

{
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "per_page": 25,
    "to": 1,
    "total": 1
  }
}

Changes