POST
/
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 '{
  "login_token": "<string>",
  "webhook_url": "<string>",
  "country": "<string>",
  "account_name": "<string>"
}'
{
  "id": "60f7b3b3e4b0c8a2d8e9f1a2",
  "login_token": "AQEDARCvKg...",
  "country": "FR",
  "webhook_url": "https://your-webhook.com/linkedin",
  "account_name": "My Pro Account",
  "is_active": false,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z"
}
Register a new LinkedIn account to receive real-time webhook notifications for messages.
After creating an account, monitoring must be started separately using the start monitoring endpoint.
Credit Usage: Real-time monitoring consumes 10 credits per day (1 credit every 144 minutes) per active account. This feature is extremely powerful for real-time LinkedIn messaging.

​
Header Parameters

​
x-api-key
string
required
Your API key

​
Body Parameters

​
login_token
string
required
LinkedIn authentication cookie (li_at) obtained from the login process
​
webhook_url
string
required
URL where webhook notifications will be sent
​
country
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR)
​
account_name
string
Optional name to identify this account

​
Response

​
id
string
Unique identifier for the created account
​
login_token
string
The LinkedIn authentication token
​
country
string
Country code used for this account
​
webhook_url
string
URL where webhooks will be sent
​
account_name
string
Account name if provided
​
is_active
boolean
Whether monitoring is currently active (false by default)
​
created_at
string
Account creation timestamp
​
updated_at
string
Last update timestamp
{
  "id": "60f7b3b3e4b0c8a2d8e9f1a2",
  "login_token": "AQEDARCvKg...",
  "country": "FR",
  "webhook_url": "https://your-webhook.com/linkedin",
  "account_name": "My Pro Account",
  "is_active": false,
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z"
}

​
Notes

  • The account will be created with is_active: false by default
  • Use the start monitoring endpoint to begin receiving webhooks
  • Credit consumption only begins when monitoring is started (not when account is created)
  • Each active account consumes credits independently