Upload the branding logo

put/v1/tenants/{tenant_id}/branding/logo

Requires an API key

Send the raw image as the body with Content-Type image/png, image/jpeg or image/webp (SVG is refused). At most 512 KB, 32 to 2048 pixels on each side, not animated. The image is re-encoded without metadata and served from the API origin with long-lived cache headers; logo.url changes whenever the image does. Set the branding first.

Path parameters

tenant_idintegerRequired

Returns · 200

display_namestringRequired
logo_urlstring | nullRequired
Null when the tenant set a name but no logo: show the name as text.
primary_colorstring | nullRequired
support_emailstring | nullRequired
support_urlstring | nullRequired
checkout_originstringRequired
Origin of the driver payment pages for this brand: the tenant's ready payment domain, else the default payment host. QR codes encode <checkout_origin>/checkout/<station>-<evse>.
sourceenumRequired
How the brand was chosen: the payment domain the page is served on, the charger's tenant, or Ivora's default.
One of payment_domain, station, tenant, default
tenant_idintegerRequired
is_defaultbooleanRequired
True while the tenant has set no branding: drivers see Ivora's.
logoobject | nullRequired
Child attributes
- urlstringRequired
  Public, cacheable URL on the API origin. Its path changes whenever the image does.
- content_typeenumRequired
  One of image/png, image/jpeg, image/webp
- widthintegerRequired
- heightintegerRequired
- bytesintegerRequired
updated_atstring | nullRequired

Errors

401 Unauthorized 403 Forbidden 404 Not found 409 Conflict 422 Invalid request 429 Rate limited 502 Upstream error 503 Unavailable

PUT /v1/tenants/{tenant_id}/branding/logo

curl --fail-with-body -X PUT "https://api.ivoracharge.com/v1/tenants/1042/branding/logo" \
  -H "Authorization: Bearer $IVORA_API_KEY"

Response · 200

{
  "display_name": "string",
  "logo_url": "https://app.example.com/return",
  "primary_color": "string",
  "support_email": "string",
  "support_url": "https://app.example.com/return",
  "checkout_origin": "https://pay.example.com",
  "source": "payment_domain",
  "tenant_id": 1042,
  "is_default": false,
  "logo": {
    "url": "https://app.example.com/ivora/webhooks",
    "content_type": "image/png",
    "width": 1,
    "height": 1,
    "bytes": 1
  },
  "updated_at": "2026-09-30T17:00:00Z"
}

Try it is not available here yetRequests from this page are off until the production API at https://api.ivoracharge.com is public. Use the code samples from your application server; Ivora grants production access. Keys are created in Developer tools.