Accounts API

Manage connected LinkedIn accounts. View status, update sending limits, check SSI scores, and monitor performance.

List Accounts

GET/api/accounts

List all connected LinkedIn accounts for the authenticated user with usage stats.

Request — cURLcURL

curl --location --request GET 'http://outreach.weezly.com/api/accounts' \
  --header 'X-API-KEY: sk_live_YOUR_API_KEY'

Response — 200 OKJSON

{
  "accounts": [
    {
      "id": "cm3acc123mno",
      "linkedinName": "John Smith",
      "linkedinHeadline": "Sales Director at Acme Corp",
      "linkedinProfileUrl": "https://linkedin.com/in/johnsmith",
      "linkedinPhotoUrl": "https://media.licdn.com/...",
      "accountType": "PREMIUM",
      "connectionCount": 2450,
      "status": "ACTIVE",
      "ssiScore": 72.5,
      "maxConnectionRequestsPerDay": 25,
      "maxMessagesPerDay": 40,
      "maxInMailsPerDay": 20,
      "maxFollowsPerDay": 30,
      "maxProfileViewsPerDay": 40,
      "maxPostLikesPerDay": 30,
      "rampUpDay": 0,
      "createdAt": "2026-05-01T08:00:00.000Z"
    }
  ]
}

Get Account

GET/api/accounts/:id

Get detailed account information including SSI scores and usage metrics.

Request — cURLcURL

curl --location --request GET 'http://outreach.weezly.com/api/accounts/:id' \
  --header 'X-API-KEY: sk_live_YOUR_API_KEY'

Response — 200 OKJSON

{
  "account": {
    "id": "cm3acc123mno",
    "linkedinName": "John Smith",
    "linkedinHeadline": "Sales Director at Acme Corp",
    "linkedinProfileUrl": "https://linkedin.com/in/johnsmith",
    "linkedinPhotoUrl": "https://media.licdn.com/...",
    "accountType": "PREMIUM",
    "connectionCount": 2450,
    "status": "ACTIVE",
    "ssiScore": 72.5,
    "ssiPreviousScore": 68.0,
    "ssiEstablishBrand": 18.5,
    "ssiFindPeople": 20.0,
    "ssiEngageInsights": 16.0,
    "ssiBuildRelationships": 18.0,
    "ssiIndustryRank": 12,
    "ssiNetworkRank": 8,
    "ssiIndustry": "Computer Software",
    "ssiLastFetchedAt": "2026-06-07T06:00:00.000Z",
    "maxConnectionRequestsPerDay": 25,
    "maxMessagesPerDay": 40,
    "maxInMailsPerDay": 20,
    "maxFollowsPerDay": 30,
    "maxProfileViewsPerDay": 40,
    "maxPostLikesPerDay": 30,
    "rampUpDay": 0,
    "dailyInvitesSent": 12,
    "dailyMessagesSent": 8,
    "lastActionAt": "2026-06-07T09:30:00.000Z",
    "createdAt": "2026-05-01T08:00:00.000Z"
  }
}

Update Account Limits

PATCH/api/accounts/:id

Update an account's daily sending limits and warm-up settings. Each limit must be between 0 and 40.

Request Body

Parameter	Type	Description
`maxConnectionRequestsPerDay`	number	Daily connection request limit (0-40)
`maxMessagesPerDay`	number	Daily message limit (0-40)
`maxInMailsPerDay`	number	Daily InMail limit (0-40)
`maxFollowsPerDay`	number	Daily follow limit (0-40)
`maxProfileViewsPerDay`	number	Daily profile view limit (0-40)
`maxPostLikesPerDay`	number	Daily post like limit (0-40)
`rampUpDay`	number	Warm-up days remaining (0 = no ramp-up, max 30)

Request — cURLcURL

curl --location --request PATCH 'http://outreach.weezly.com/api/accounts/:id' \
  --header 'X-API-KEY: sk_live_YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "maxConnectionRequestsPerDay": 20,
  "maxMessagesPerDay": 35,
  "rampUpDay": 7
}'

Response — 200 OKJSON

{
  "account": {
    "id": "cm3acc123mno",
    "maxConnectionRequestsPerDay": 20,
    "maxMessagesPerDay": 35,
    "maxInMailsPerDay": 20,
    "maxFollowsPerDay": 30,
    "maxProfileViewsPerDay": 40,
    "maxPostLikesPerDay": 30,
    "rampUpDay": 7
  }
}

Get SSI Score

GET/api/accounts/:id/ssi

Get the Social Selling Index score for an account. Cached for 24 hours. Use ?force=true to refresh.

Query Parameters

Parameter	Type	Description
`force`	boolean	Force refresh from LinkedIn (bypasses 24h cache)

Request — cURLcURL

curl --location --request GET 'http://outreach.weezly.com/api/accounts/:id/ssi' \
  --header 'X-API-KEY: sk_live_YOUR_API_KEY'

Response — 200 OKJSON

{
  "ssi": {
    "score": 72.5,
    "previousScore": 68.0,
    "establishBrand": 18.5,
    "findPeople": 20.0,
    "engageInsights": 16.0,
    "buildRelationships": 18.0,
    "industryRank": 12,
    "networkRank": 8,
    "industry": "Computer Software",
    "industryAvg": 35.2,
    "networkAvg": 42.1,
    "lastFetchedAt": "2026-06-07T06:00:00.000Z"
  },
  "recommendations": {
    "tier": "Excellent",
    "connectionRequests": 25,
    "messages": 40,
    "inmails": 20,
    "follows": 30,
    "profileViews": 40,
    "postLikes": 30
  }
}

Account Performance

GET/api/accounts/:id/performance

Get performance metrics for an account over a time period.

Query Parameters

Parameter	Type	Description
`days`	number	Number of days (default: 30)
`campaignId`	string	Filter by campaign

Request — cURLcURL

curl --location --request GET 'http://outreach.weezly.com/api/accounts/:id/performance' \
  --header 'X-API-KEY: sk_live_YOUR_API_KEY'

Response — 200 OKJSON

{
  "performance": {
    "connectionsSent": 450,
    "connectionsAccepted": 135,
    "connectionRate": 30.0,
    "messagesSent": 135,
    "repliesReceived": 18,
    "replyRate": 13.3,
    "inmailsSent": 25,
    "profileViews": 500,
    "daily": [
      { "date": "2026-06-01", "connectionsSent": 15, "messagesSent": 8, "replies": 2 }
    ]
  }
}

Pause Account

POST/api/accounts/:id/pause

Pause an account. Stops all outreach activity for this account across all campaigns.

Request — cURLcURL

curl --location --request POST 'http://outreach.weezly.com/api/accounts/:id/pause' \
  --header 'X-API-KEY: sk_live_YOUR_API_KEY'

Response — 200 OKJSON

{ "account": { "id": "cm3acc123mno", "status": "PAUSED" } }

Resume Account

POST/api/accounts/:id/resume

Resume a paused account.

Request — cURLcURL

curl --location --request POST 'http://outreach.weezly.com/api/accounts/:id/resume' \
  --header 'X-API-KEY: sk_live_YOUR_API_KEY'

Response — 200 OKJSON

{ "account": { "id": "cm3acc123mno", "status": "ACTIVE" } }

Account Statuses

ACTIVE	Account is healthy and sending
PAUSED	Temporarily paused by user or rate limiting
WARNED	LinkedIn detected unusual activity — auto-paused
ERROR	Account connection lost or authentication expired
RECONNECTING	Account is being reconnected