Skip to main content
POST
https://api.linkupapi.com
/
v1
/
webhooks
/
accounts
Create Webhook Account
curl --request POST \
  --url https://api.linkupapi.com/v1/webhooks/accounts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "platform": "<string>",
  "account_name": "<string>",
  "webhook_url": "<string>",
  "login_token": "<string>",
  "phone_number": "<string>",
  "qr_webhook_url": "<string>"
}
'
{
  "id": "60f7b3b3e4b0c8a2d8e9f1a2",
  "platform": "linkedin",
  "account_name": "My LinkedIn Account",
  "login_token": "AQEDARCvKg...",
  "country": "FR",
  "webhook_url": "https://your-webhook.com/linkedin",
  "is_active": false,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z"
}
Register a new LinkedIn or WhatsApp account to receive real-time webhook notifications.
LinkedIn: After creating an account, monitoring must be started separately using the start monitoring endpoint.WhatsApp: QR code generation starts immediately after account creation. QR codes expire after 20 sec and are regenerated automatically.
Credit Usage: Real-time monitoring consumes 10 credits per day (1 credit every 144 minutes) per active LinkedIn account. WhatsApp pricing may differ - contact support for details.

​
Header Parameters

​
x-api-key
string
required
Your API key

​
Body Parameters

​
platform
string
required
Platform type: "linkedin" or "whatsapp"
​
account_name
string
required
Name to identify this account
​
webhook_url
string
required
URL where webhook notifications will be sent
​
country
string
Country code used for this account

​
LinkedIn-specific Parameters

​
login_token
string
required
LinkedIn authentication token obtained from the login process

​
WhatsApp-specific Parameters

​
phone_number
string
required
Phone number in international format (e.g., +33612345678)
​
qr_webhook_url
string
URL for QR code notifications (defaults to webhook_url if not provided)

​
Response

​
id
string
Unique identifier for the created account
​
platform
string
Platform type (linkedin or whatsapp)
​
account_name
string
Account name
​
webhook_url
string
URL where webhooks will be sent
​
is_active
boolean
Whether monitoring is currently active (false by default)
​
is_authenticated
boolean
Whether the account is authenticated (WhatsApp only)
​
needs_qr
boolean
Whether QR code authentication is needed (WhatsApp only)
​
country
string
Country code used for this account (LinkedIn only)

​
LinkedIn-specific Response Fields

​
login_token
string
The LinkedIn authentication token (LinkedIn only)

​
WhatsApp-specific Response Fields

​
phone_number
string
Phone number in international format (WhatsApp only)
​
qr_webhook_url
string
URL for QR code notifications (WhatsApp only)
​
created_at
string
Account creation timestamp
​
updated_at
string
Last update timestamp
{
  "id": "60f7b3b3e4b0c8a2d8e9f1a2",
  "platform": "linkedin",
  "account_name": "My LinkedIn Account",
  "login_token": "AQEDARCvKg...",
  "country": "FR",
  "webhook_url": "https://your-webhook.com/linkedin",
  "is_active": false,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z"
}

​
Notes

  • LinkedIn: Account created with is_active: false. Use start monitoring endpoint to begin receiving webhooks
  • WhatsApp: QR code generation starts immediately after account creation. QR codes expire after 20 sec and regenerate automatically
  • LinkedIn: Credit consumption only begins when monitoring is started
  • WhatsApp: To stop monitoring, delete the account entirely
  • Each active account consumes credits independently