Users, contacts, and broadcasts

These endpoints operate on the connected WhatsApp account and its contacts.

User lookup

Endpoint	Body	Use
`POST /user/check`	`Phone: []string`	Check whether phone numbers are on WhatsApp.
`POST /user/info`	`Phone: []string`	Fetch WhatsApp user info for one or more users.
`POST /user/avatar`	`Phone`, `Preview`	Fetch profile picture information for a user.
`GET /user/avatar`	none	Route exists, but the handler reads JSON body. Prefer POST for target avatars.
`POST /user/parselid`	`lid`	Convert an LID value to a parsed JID.

Example:

{
  "Phone": ["15551234567", "15557654321"]
}

Endpoint	Use
`GET /user/privacy`	Get privacy settings for the connected account.
`GET /user/contacts`	List locally stored contacts for the account.
`GET /user/blocklist`	List blocked contacts.
`GET /user/limits`	Get messaging cap and reachout timelock information.
`GET /user/appstate`	Refetch app state for the connected account.

Endpoint	Body	Use
`POST /user/profile`	`Image`	Set the account profile picture from a base64 image data URL.
`POST /user/name`	`Name`	Update the account push name.
`POST /user/presence`	`Presence`	Set account presence. Valid values are `available` or `unavailable`.

curl -X POST http://localhost:1337/user/block \
  -H "Content-Type: application/json" \
  -H "token: YOUR_TOKEN" \
  -d '{"Phone":"15551234567"}'

Use /user/unblock with the same body to unblock.

Endpoint	Body	Use
`POST /contact/add`	`Phone`, `FirstName`, `FullName`, `SaveOnBook`	Save a WhatsApp contact action for the account.
`POST /contact/remove`	`Phone`	Remove a contact action for the account.

These actions affect WhatsApp contact state, not necessarily the phone’s native address book.

POST /broadcast/listparticipants accepts:

{
  "id": "broadcast-id"
}

It returns the participants known for that broadcast.