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

FieldShown asRules
displayNameCompany name at the top and on the reward cardUp to 80 characters. Empty = your account name
logoUrlLogo in the header and on the cardhttps:// only. An uploaded logo wins over the URL
primaryColorGift box wrapping, page glow, buttons6-digit hex, e.g. #7C3AED
accentColorRibbon, light burst, highlights6-digit hex, e.g. #EC4899
redeemInstructionsText under the QR codeUp to 400 characters
supportPhone“Call” button on the cardDigits, spaces, + - ( )
supportEmail“Email” button on the cardA valid email address
websiteUrl“Website” buttonhttps:// only
termsUrl“Terms” buttonhttps:// 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"
}

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

CodeWhen
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