Getting Your Credentials
API Token
To create an API token:
- Log in to your Redo Dashboard
- Go to Settings → Developer
- Click Add API Client
- Copy the generated API secret
Store your API secret securely. It will only be shown once when created.
Store ID
Your Store ID is displayed in the General section of Settings → Developer in the Redo Dashboard.
API Endpoints
All API endpoints are authenticated using the Bearer authorization scheme with your API secret.
Include your API secret in the Authorization header of every request:
GET /v2.2/stores/{storeId}/returns HTTP/1.1
Authorization: Bearer 77bb7598b7a972475cc7c7e171ec33af
Host: api.getredo.com
Never share your API secret publicly or commit it to version control.
Example Request
curl -X GET "https://api.getredo.com/v2.2/stores/store_123/returns" \
-H "Authorization: Bearer YOUR_API_SECRET"
Webhooks
Webhooks are authenticated using the Bearer authorization scheme with a secret you provide when creating the webhook subscription.
Redo will include this secret in the Authorization header when delivering webhook events to your endpoint:
POST /events HTTP/1.1
Authorization: Bearer subscriberauth123
Host: subscriber.example.com
Always verify the Authorization header in your webhook handler before processing events.
Webhook Event Delivery
- Webhook events are delivered in order for each individual subject (e.g., return)
- If the response is not a 2xx status code, the event will be retried multiple times before discarding it
See the Webhooks guide for detailed setup instructions.