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.
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.
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/...
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 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"
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