Skip to content
Englishالعربية
Build it for me

Contacts

Share a contact they can save in one tap.

A contact card with a name and a number. Add wa_id to get the "Message" and "Save contact" buttons.

to and the message ids are n8n expressions that read the WhatsApp Trigger right before this node ($json.messages[0].from / .id). For a manual test, replace them with a number and a message id.

The JSON body

HTTP Request → Body → JSON
POSThttps://graph.facebook.com/v26.0/YOUR_PHONE_NUMBER_ID/messages
{  "messaging_product": "whatsapp",  "recipient_type": "individual",  "to": "{{ $json.messages[0].from }}",  "type": "contacts",  "contacts": [    {      "name": {        "formatted_name": "Customer support",        "first_name": "Support"      },      "phones": [        {          "phone": "+20 1XX XXX XXXX",          "type": "WORK",          "wa_id": "201XXXXXXXXX"        }      ]    }  ]}

Limits & common mistakes

  1. Only formatted_name is required; everything else is optional.

    Source (opens in a new tab)

  2. With wa_id (the number with country code, no +) the card shows "Message" and "Save contact"; without it, "Invite to WhatsApp".

    Source (opens in a new tab)

  3. Up to 257 contacts in one message; keep it to a few.

    Source (opens in a new tab)

  4. Replace the placeholders +20 1XX XXX XXXX and 201XXXXXXXXX with your real contact before running.

    Source (opens in a new tab)
How to set up the credential in n8n
  1. In n8n, open Credentials → Create credential and pick Header Auth.
  2. Fill in the two fields:
    NameAuthorization
    ValueBearer <your token>
  3. Open the pasted node. Authentication is already Generic → Header Auth; choose the credential you just made.
  4. Use a System User token from Meta Business settings; the token on the API Setup page expires within hours.Source (opens in a new tab)Source (opens in a new tab)

Your token lives in n8n only. I never ask for it.

Don't have time to build it? I'll build it for you.

Build it for me

WhatsApp and n8n are trademarks of their owners. Pixtaha isn't affiliated with or endorsed by Meta or n8n.