The Walls.io Echo REST API
Walls.io Echo comes with a public REST API that gives you programmatic access to everything you see in your dashboard: read your campaigns, their recent shares, and the full set of analytics — pageviews, shares, clicks, viral boost, and conversions — or create, update, and delete campaigns, their sharing visuals (up to 10 per campaign, each with its own personalization layout), and the folders that organize them, right from your own tools.
💡 Hint: You can find the full API documentation at https://api.echo.walls.io!
The API lives at https://api.echo.walls.io/v1 and returns clean JSON, so it plugs into any tool, script, or platform that can make an HTTPS request.
What You Can Do With It
Feed your BI dashboards — Pull campaign metrics into Looker Studio, Power BI, Grafana, or your internal reporting stack, so Echo performance sits next to the rest of your marketing data.
Automate reporting — Schedule a script or a no-code workflow (Zapier, Make, n8n) that fetches last week's numbers every Monday morning and posts a summary to Slack or email.
Show live social proof — Display a live share counter or a "recently shared by" feed on your event or campaign website, powered by the shares endpoint.
Sync advocates to your CRM — Fetch a campaign's top sharers (with their click and conversion counts) and push them to HubSpot or Salesforce to follow up with your most effective ambassadors.
Monitor and alert — Poll the daily timeseries and trigger a notification when a campaign suddenly spikes — or stalls.
Automate campaign management — Create campaigns programmatically, for example spinning up a ready-to-share campaign for every event in your calendar — and keep them organized in folders as you go.
Manage sharing visuals — Upload up to 10 sharing visuals per campaign, adjust each visual’s personalization layout (name, role, custom fields, profile picture), reorder them, or remove them.
Getting Started
In your Dashboard, go to Settings → API and create a personal access token.
Choose Read only for reporting, or Read & write if the token should also manage campaigns and folders.
Copy the token and send it as a
Bearertoken in theAuthorizationheader of your requests (or use the HTTP parameteraccess_tokeninstead)That's it — start with
GET https://api.echo.walls.io/v1/campaignsto list your campaigns.
The API only ever operates on campaigns and folders owned by your account — and creating, updating, or deleting them requires a token created with Read & write access, so read-only tokens stay safe to share with reporting tools.
Full API Reference
The complete, interactive documentation — every endpoint, all parameters, and ready-to-copy code samples for cURL, PHP, and Node.js — can be found at https://api.echo.walls.io.
It includes a built-in test console, so you can try every endpoint with your own token straight from the browser.
💡 Hint: Prefer talking to your data instead of coding against it? Walls.io Echo also has an MCP server that connects AI assistants like Claude and ChatGPT directly to your campaigns.
If you have further questions, don't hesitate to contact the support team via chat or support@walls.io!