Add Members

Adds members to a list. Identify each member by its linkedin_url or linkedin_handle (preferred). For company lists, a domain (e.g. stripe.com) is also accepted as a fallback when no LinkedIn identifier is available. Providing a domain on a people list is reported as a row error.

The identifier has to match the list kind. A personal LinkedIn URL sent to a company list, a company LinkedIn URL sent to a profile list, a domain on a profile list, or a bare handle we already know to be the wrong sort is reported as a wrong_entity_type row in errors, one row per mismatching member. A value that is not a usable identifier, such as a domain without a dot or a LinkedIn URL with no handle, is reported as invalid_identifier. The other members of the request are still added.

For champion lists, each member can also carry a company — the company where you know this contact today. Add the champion now, and once their profile shows a different company, Sillage reports it as a job change. Providing company on any other list returns 422.

New members start with no tracking override, so they follow the list's default_tracking_status and default_signal_bucket. Give one member a value of its own with Set member tracking status.

A list can be set inside Sillage to fill itself from your CRM. Such a list decides its own members, so adding one by hand is refused with 409 and nothing is added.

The call is partial-success: members that were added appear in data, and any per-member failures appear in errors. A 200 response means the request was accepted, always inspect errors for any that were not added. Re-adding members that are already present is safe and returns 200 with an empty data array. If no members could be added because every one failed, the response is 422 with data: [] and errors populated.

Add members

Path parameters

Request body

Example request

curl -X POST "https://api.getsillage.com/api/v2/lists/company/128/members" \
  -H "Authorization: Bearer $SILLAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "members": [
        { "linkedin_url": "https://www.linkedin.com/company/openai" },
        { "linkedin_handle": "anthropic" }
      ] }'

Example request — champion with company context

Adding a champion whose current company you know today. Once their profile shows a different company, this becomes a job-change signal.

curl -X POST "https://api.getsillage.com/api/v2/lists/profile/204/members" \
  -H "Authorization: Bearer $SILLAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "members": [
        {
          "linkedin_url": "https://www.linkedin.com/in/jane-doe",
          "company": { "name": "OpenAI", "domain": "openai.com" }
        }
      ] }'

Example response

Each member's id identifies the company or person on this list — pass it to Remove member. The shape follows the list kind: company lists return name and logo_url, people lists return first_name / last_name. tracking_status and signal_bucket come back null on a freshly added member, meaning it follows the list defaults.

The response always includes both data (added members) and errors (per-member failures). A 200 means the request was accepted. Inspect errors to identify any members that could not be added.

{
  "data": [
    {
      "id": 901,
      "name": "OpenAI",
      "linkedin_handle": "openai",
      "linkedin_url": "https://www.linkedin.com/company/openai",
      "logo_url": "https://media.licdn.com/dms/image/openai-logo.png",
      "tracking_status": null,
      "signal_bucket": null
    },
    {
      "id": 902,
      "name": "Stripe",
      "linkedin_handle": null,
      "linkedin_url": null,
      "tracking_status": null,
      "signal_bucket": null
    }
  ],
  "errors": [
    {
      "input": { "domain": "acme.com" },
      "code": "multiple_domain_matches",
      "message": "The domain matched more than one company. Provide a LinkedIn URL or handle to identify the exact company."
    }
  ]
}

Per-member error codes

When a member cannot be added, its failure is reported in errors rather than failing the whole request.

Status codes