IgnitePost public API reference

Authentication

We're using API keys for authentication.

Set up an API key at profile/API Keys

You have to provide the secret token when making API calls as a request header in the following format:

X-TOKEN: your-secret-api-token

Testing the authentication can be done by querying the https://dashboard.ignitepost.com/api/v1/authenticate endpoint (see below).


Errors

We use HTTP response codes to indicate the success or failure of an API request:


Common Objects

The Order Object

The fields of an IgnitePost order are as follows:

id: string - Unique identifier for the order
uid: string - Unique external identifier for the orders from your own system
message: string - The letter text
font: string
image_url: string
insert: string
metadata: hash - Use this field to attach key-value data to order objects.
                 As an example, you could store your user's name, id.
recipient_name: string
recipient_email: string
recipient_company_name: string
recipient_address_one: string
recipient_address_two: string
recipient_city: string
recipient_state: string
recipient_zip: string
sender_name: string
sender_address_one: string
sender_address_two: string
sender_city: string
sender_state: string
sender_zip: string
created_at: datetime
send_on: date
sent_at: datetime

Test Mode

There are two ways to use the API in test mode: 1. Send an 'X-TESTING' request header with the value of 'true' 2. Use an API key that has not been switched to live

When the API is in test mode the orders you send will not be persisted.


Endpoints

Authenticate

{ "email":"your@email.com" }
curl -H "X-TOKEN: aVaLIdAP1t0kEN" -X GET https://dashboard.ignitepost.com/api/v1/authenticate

List letter templates

{
  "data": [
    {
      "id" :"42",
      "name": "Congratulations Card",
    },
    {...},
    {...}
  ]
}
curl -H "X-TOKEN: aVaLIdAP1t0kEN" -X GET https://dashboard.ignitepost.com/api/v1/letter_templates

List fonts

{
  "data": [
    {
      "key": "becca",
      "label": "Becca"
    },
    {...},
    {...}
  ]
}
curl -H "X-TOKEN: aVaLIdAP1t0kEN" -X GET https://dashboard.ignitepost.com/api/v1/fonts

List default images

{
  "data": [
    {
      "key": "thank_you",
      "label": "Thank You",
      "url": "http://ignitepost.com/thank-you.jpg"
    },
    {...},
    {...}
  ]
}
curl -H "X-TOKEN: aVaLIdAP1t0kEN" -X GET https://dashboard.ignitepost.com/api/v1/images

List inserts

{
  "data": [
    {
      "key" :"starbucks_5_giftcard",
      "name": "$5 Starbucks Giftcard",
      "denomination": 5.0,
      "purchase_fee": 0.0
    },
    {...},
    {...}
  ]
}
curl -H "X-TOKEN: aVaLIdAP1t0kEN" -X GET https://dashboard.ignitepost.com/api/v1/inserts

Retrieve an order

curl -H "X-TOKEN: aVaLIdAP1t0kEN" -X GET https://dashboard.ignitepost.com/api/v1/orders/42

Create an order

font: string (required)
  - accepted values
    - known IgnitePost fonts - see the list fonts endpoint
message: string (required)
  - accepted values
    - max length of 450 chars
image: string (required)
  - accepted values
    - a known IgnitePost image-key - see the default images endpoint
    - an image url (max file size: 4mb, max dimensions: 4200px width x 3000px height)
    - an image data stream (max file size: 4mb, max dimensions: 4200px width x 3000px height)
insert: string (optional)
  - accepted values
    - known IgnitePost inserts - see the list inserts endpoint
recipient_name: string (optional)
recipient_email: string (optional)
recipient_company_name: string (optional)
recipient_address_one: string (required)
recipient_address_two: string (optional)
recipient_city: string (required)
recipient_state: string (required)
recipient_zip: string (required)
sender_name: string (optional)
sender_address_one: string (optional)
sender_address_two: string (optional)
sender_city: string (optional)
sender_state: string (optional)
sender_zip: string (optional)
send_on: date (optional)
  - leave this field empty to send order ASAP
  - format YYYY-MM-DD
letter_template_id: integer (optional)
  - accepted values
    - see the list letter-templates endpoint
    - arguments passed in the create order payload will override the template attributes
uid: string (optional)
metadata: hash (optional) - attach key-value data to your order objects
curl -H "X-TOKEN: aVaLIdAP1t0kEN" -X POST https://dashboard.ignitepost.com/api/v1/orders -d 'message=Thank you for your business' -d 'font=pea' -d 'image=thank_you' -d 'recipient_name=Stan Marsh' -d 'recipient_address_one=1st Main str' -d 'recipient_city=South Park' -d 'recipient_state=CO' -d 'recipient_zip=12345'

Preview note

font: string (required)
message: string (required)
image: string (required - this argument can be:
               a known IgnitePost image-key
               an image url or
               an image data stream)
{
  "front": "http://ignitepost.com/front.jpg",
  "inside": "http://ignitepost.com/inside.jpg"
}
curl -H "X-TOKEN: aVaLIdAP1t0kEN" -X POST https://dashboard.ignitepost.com/api/v1/preview -d 'message=Lorem ipsum dolor sit amet' -d 'font=pea' -d 'image=thank_you'

Webhooks

You can also use webhooks for receiving a notification once an order is fulfilled.

Set them up at profile/Webhooks


Known Issues

We'll be listing here any issues that are brought to our attention until we can fix them.