Skip to main content

Using the Walls.io Echo API

How to integrate Walls.io Echo using our API

Written by Michael Kamleitner

The Walls.io Echo REST API

Walls.io Echo comes with a public REST API that gives you programmatic, read-only access to everything you see in your dashboard: your campaigns, their recent shares, and the full set of analytics — pageviews, shares, clicks, viral boost, and conversions.

💡 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.

💡 Hint: the Walls.io Echo API is currently read-only! This means it's currently not possible to create or edit campaigns!

Getting Started

  1. In your Dashboard, go to Settings → API and create a personal access token.

  2. Copy the token and send it as a Bearer token in the Authorization header of your requests (or use the HTTP parameter access_token instead)

  3. That's it — start with GET https://api.echo.walls.io/v1/campaigns to list your campaigns.

The API only ever returns data for campaigns owned by your account.

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!

Did this answer your question?