Skip to content
Swft Docs

Agency Portal

The Swft agency portal lets digital agencies manage multiple merchant accounts from a single login. Agencies can provision merchants, monitor checkout performance across their client portfolio, apply consistent configurations, and access consolidated billing.

What the agency portal provides

Section titled “What the agency portal provides”
  • A single dashboard at app.swft.co.uk/agency covering all linked merchants
  • Per-merchant analytics: conversion rate, revenue, TTFB, top drop-off steps
  • Bulk config actions: push a template or module setting to multiple merchants at once
  • Client-facing reports (PDF export or shareable link)
  • Consolidated invoicing for agencies on the Agency or White-Label plan

Registering an agency account

Section titled “Registering an agency account”

Send a POST to /agencies/register with your agency details:

Terminal window
curl -X POST https://api.swft.co.uk/v1/agencies/register \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Agency Ltd",
    "email":   "[email protected]",
    "website": "https://acmeagency.com",
    "plan":    "agency"
  }'

Response:

{
  "agencyId":  "agc_xxxxxxxx",
  "apiKey":    "sk_swft_agency_xxxxxxxxxxxxxxxx",
  "dashboardUrl": "https://app.swft.co.uk/agency/agc_xxxxxxxx"
}

Store the apiKey securely — it has elevated permissions and can act on behalf of any linked merchant.

Linking merchants

Section titled “Linking merchants”

After registering, link existing merchant accounts to your agency:

Terminal window
curl -X POST https://api.swft.co.uk/v1/agencies/{agencyId}/merchants \
  -H "Authorization: Bearer $SWFT_AGENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": "mer_xxxxxxxx"
  }'

The merchant receives an email asking them to approve the link. Once approved, their account appears in your agency dashboard. Merchants retain full access to their own account — linking an agency does not transfer ownership.

You can also create a new merchant account directly from the agency (no approval step needed):

Terminal window
curl -X POST https://api.swft.co.uk/v1/agencies/{agencyId}/merchants/create \
  -H "Authorization: Bearer $SWFT_AGENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":       "Client Store Name",
    "email":      "[email protected]",
    "websiteUrl": "https://clientstore.com",
    "plan":       "grow"
  }'

Agency API key scopes

Section titled “Agency API key scopes”

The agency API key (sk_swft_agency_*) can perform any action a merchant key can, across all linked merchants. Specify the target merchant in the X-Swft-Merchant header:

Terminal window
curl https://api.swft.co.uk/v1/sessions \
  -H "Authorization: Bearer $SWFT_AGENCY_KEY" \
  -H "X-Swft-Merchant: mer_xxxxxxxx"

Without the X-Swft-Merchant header, the request targets the agency account itself (e.g. for aggregated analytics).

Agency dashboard

Section titled “Agency dashboard”

Log in at app.swft.co.uk/agency to access:

Portfolio overview — all merchants in a table: name, plan, 30-day revenue, conversion rate, last checkout activity, and a quick-link to each merchant’s settings.

Performance comparison — bar chart ranking merchants by conversion rate, revenue, or TTFB. Useful for identifying underperforming clients.

Bulk actions — select multiple merchants and push a config change (e.g. enable address autocomplete for all clients at once).

Reports — generate a branded PDF performance report for any merchant covering the selected date range. Reports include funnel metrics, device split, top products, and recovery stats.

White-label plans

Section titled “White-label plans”

On the White-Label plan, the Swft checkout UI removes all Swft branding:

  • “Powered by Swft” footer link removed
  • Email templates use your agency’s branding
  • The checkout domain can be checkout.youragency.com (custom domain per merchant, managed by your agency)
  • Client-facing dashboards at app.youragency.com (requires DNS delegation)

To enquire about the White-Label plan, email [email protected] or open a conversation via the agency dashboard.