Branding
Your customers open gifts on a page with your name, logo and colours, and a way to reach you. Set it once in the portal (Branding, under Rewards) or from your system with the API. It applies to every link, including ones already sent.
What you can set
| Field | Shown as | Rules |
|---|---|---|
displayName | Company name at the top and on the reward card | Up to 80 characters. Empty = your account name |
logoUrl | Logo in the header and on the card | https:// only. An uploaded logo wins over the URL |
primaryColor | Gift box wrapping, page glow, buttons | 6-digit hex, e.g. #7C3AED |
accentColor | Ribbon, light burst, highlights | 6-digit hex, e.g. #EC4899 |
redeemInstructions | Text under the QR code | Up to 400 characters |
supportPhone | “Call” button on the card | Digits, spaces, + - ( ) |
supportEmail | “Email” button on the card | A valid email address |
websiteUrl | “Website” button | https:// only |
termsUrl | “Terms” button | https:// only |
Send only the fields you want to change. Send null or "" to clear one.
Update branding
Use the Auth Token, or an API key with the branding:manage permission.
POST /v1/Branding
curl -X POST https://api-rewards.efiqone.com/v1/Branding \
-u $ACCOUNT_SID:$AUTH_TOKEN \
-H "Content-Type: application/json" \
-d '{
"displayName": "RAPI pro Ltd",
"logoUrl": "https://rapi.example/logo.png",
"primaryColor": "#1D4ED8",
"accentColor": "#F59E0B",
"redeemInstructions": "Show this QR at any RAPI store, or use the code at checkout.",
"supportPhone": "+91 80 1234 5678",
"supportEmail": "help@rapi.example",
"websiteUrl": "https://rapi.example"
}'
{
"account_sid": "AC5f2c…",
"display_name": "RAPI pro Ltd",
"name_shown": "RAPI pro Ltd",
"logo_url": "https://rapi.example/logo.png",
"logo_uploaded": false,
"logo_shown": "https://rapi.example/logo.png",
"primary_color": "#1D4ED8",
"accent_color": "#F59E0B",
"website_url": "https://rapi.example",
"support_email": "help@rapi.example",
"support_phone": "+91 80 1234 5678",
"redeem_instructions": "Show this QR at any RAPI store, or use the code at checkout.",
"terms_url": null,
"date_updated": "2026-11-12T16:05:11.000Z"
}Upload a logo file
If your logo isn’t hosted anywhere, upload it. We host it with the gift page. PNG, JPG or WebP, up to 512 KB, sent as base64 (a data: URL also works).
POST /v1/Branding/Logo
curl -X POST https://api-rewards.efiqone.com/v1/Branding/Logo \
-u $ACCOUNT_SID:$AUTH_TOKEN \
-H "Content-Type: application/json" \
-d "{\"data\": \"$(base64 -w0 logo.png)\"}"DELETE /v1/Branding/Logo removes the uploaded logo (the logoUrl, if set, is used again). GET /v1/Branding returns the current settings.
SVG logos aren’t accepted, because SVG files can contain scripts. Export a PNG instead.
Errors
| Code | When |
|---|---|
| 20001 (400) | A field is invalid, for example a colour that isn’t #RRGGBB, an http:// URL, or a logo over 512 KB or not PNG/JPG/WebP |
| 20301 (403) | The API key doesn’t have branding:manage |