Developer API

Send stickers from code.

Mail stickers to your users with Sticker Space's API. Send stickers when users sign up, pass a spending threshold, or interact with customer service.

Overview

Sticker Space API requests are always made to a subdomain (e.g. https://your.sticker.space). All requests must be secure, i.e. https.

You agree to Sticker Space's Terms of Service by using our API.

Authentication

All Sticker Space API requests are authenticated using your email and a developer token. Your email is the email you used when you created your Sticker Space account. You can find your developer token in your space's management page (e.g. https://your.sticker.space/manage).

Supply your credentials on every API call.

curl -H 'Authorization: [email] [token]' https://your.sticker.space/...

API

Mail a Sticker

Mail a sticker to a physical address.

curl \ -H "Authorization: $STICKER_SPACE_EMAIL $STICKER_SPACE_API_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ https://your.sticker.space/requests \ -d '{   "request": {     "email": "clark344@aol.com",     "name": "Clark Kent",     "address_1": "344 Clinton St.",     "address_2": "Apt. #3B",     "city": "Metropolis",     "state": "DE",     "zip": "19808",     "country": "US"   } }'

Custom fields may also be included in the request payload. Be sure to use the case-sensitive custom field key in the request.

Email a Sticker Link

Email someone a single-use sticker link. Sticker requests are pre-approved when users submit their address using the emailed link.

curl \ -X POST \ -H "Authorization: $STICKER_SPACE_EMAIL $STICKER_SPACE_API_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ "https://your.sticker.space/emails?email=clark344@aol.com"
Generate a Private Link

Share single-use private links with individuals. Sticker requests are pre-approved when users submit their address using a private link.

curl \ -X POST \ -H "Authorization: $STICKER_SPACE_EMAIL $STICKER_SPACE_API_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ https://your.sticker.space/links