n8n is the recommended middleware for connecting Facebook Lead Ads, Google Sheets, or any CRM to Wavio.

1. In n8n, create a new Workflow
2. Add your trigger node (e.g. Facebook Lead Ads, Webhook, or Schedule)
3. Add an HTTP Request node after the trigger
4. Configure the HTTP Request node as shown below
5. Map the fields from the trigger to the request body

Method:       POST
URL:          https://your-domain.com/api/v1/leads
Auth Type:    Header Auth
Header Name:  Authorization
Header Value: Bearer wv_live_your_key_here

Body (JSON):
{
  "name":      "{{ $json.full_name }}",
  "phone":     "{{ $json.phone_number }}",
  "source":    "n8n",
  "form_data": {{ $json.toJsonString() }}
}

1. Create a new Scenario in Make
2. Add your trigger module (Facebook Lead Ads, Google Forms, etc.)
3. Add an HTTP → Make a Request module
4. Configure the module as shown below

URL:     https://your-domain.com/api/v1/leads
Method:  POST
Headers:
  Authorization: Bearer wv_live_your_key_here
  Content-Type: application/json

Body (Raw JSON):
{
  "name":   "{{1.name}}",
  "phone":  "{{1.phone}}",
  "source": "facebook",
  "form_data": { "city": "{{1.city}}" }
}

1. Create a new Zap
2. Set the Trigger to your source (Facebook Lead Ads, Typeform, etc.)
3. Add an Action step: Webhooks by Zapier → POST
4. Configure the Webhook step as shown below

URL:          https://your-domain.com/api/v1/leads
Payload Type: json
Headers:
  Authorization: Bearer wv_live_your_key_here

Data (key: value):
  name:   Full Name field from trigger
  phone:  Phone Number field from trigger
  source: facebook

Two recommended approaches: via n8n/Make as middleware, or using HubSpot Workflows with the HTTP Request action.

1. Go to Automation → Workflows in HubSpot
2. Create a Contact-based workflow with your trigger (e.g. Form submitted)
3. Add action: Send a webhook
4. Set Method to POST and URL to your Wavio endpoint
5. Add the Authorization header with your API key
6. Map HubSpot contact properties to the JSON body

URL:    https://your-domain.com/api/v1/leads
Method: POST
Headers:
  Authorization: Bearer wv_live_your_key_here

Request body:
{
  "name":   "{{ contact.firstname }} {{ contact.lastname }}",
  "phone":  "{{ contact.phone }}",
  "source": "hubspot"
}

Connect HubSpot as a trigger in n8n or Make, then use the HTTP Request node to call Wavio. This gives you more control over data transformation.

1. Go to Developer → Integrations
2. Under Facebook Lead Ads, click Connect Facebook Account
3. Log in with the Facebook account that manages your client's page
4. Select the Facebook page you want to receive leads from
5. Done — leads flow into Wavio automatically from that moment

Hi {{name}}! 👋
 
Thanks for your interest.
We received your details from our Facebook ad.
 
Someone from our team will reach out to you 
on WhatsApp shortly. Stay tuned! 🚀

Capture leads from any form on your client's website — quote forms, contact forms, WhatsApp click-to-chat buttons — without changing how the forms look or work.

1. Go to Developer → Integrations
2. Under Google Tag Manager, click Connect Google Account
3. Select the GTM container for your client's website
4. Click Install — Wavio automatically creates and publishes the tag
5. Done — all form submissions on that website are now captured as leads

1. Go to Developer → Integrations
2. Under Website Form Capture, select your API key
3. Copy the generated snippet
4. Paste it on the client's website just before the </body> tag

<!-- Paste before </body> -->
<script src="https://your-domain.com/capture.js?key=YOUR_API_KEY" async></script>

Use this to test your integration or connect a custom system directly.

curl -X GET https://your-domain.com/api/v1/ping \
  -H "Authorization: Bearer wv_live_your_key_here"

curl -X POST https://your-domain.com/api/v1/leads \
  -H "Authorization: Bearer wv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ahmad","phone":"962791234567","source":"test","form_data":{"city":"Amman"}}'

const res = await fetch('https://your-domain.com/api/v1/leads', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wv_live_your_key_here',
    'Content-Type':  'application/json'
  },
  body: JSON.stringify({ name: 'Ahmad', phone: '962791234567', source: 'api' })
});
const data = await res.json();
console.log(data); // { success: true, lead_id: '...' }