Skip to main content
POST
Start a LinkedIn connect for a new sender profile

Authorizations

Authorization
string
header
required

Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of start_new_sender_profile_linkedin_connect.

proxy_country_code
string | null

ISO 3166-1 alpha-2 country for a browser off the MANAGED proxy pool. Default US. Offer only what list_sender_profile_linkedin_proxy_countries reports in stock: a country with no free proxy is a 422 proxy_pool_empty on this field.

Required string length: 2
custom_proxy_config
object | null

Route the minted browser through the team's OWN proxy, not the managed pool; ip and port required when sent. Check it first with check_sender_profile_linkedin_proxy: the connect probes again and refuses a dead one (422 custom_proxy_unreachable_{kind}).

vendor_profile_id
string | null

The team's OWN GoLogin profile id: 24 hex characters, the id shown in GoLogin, never the profile URL or a share link. Its proxy stays on the profile, so no proxy field may accompany it.

history_since
string | null

The account's history window: import its conversations from this day (YYYY-MM-DD) on, into the inbox and the people's activity, or none of the past with now (only what arrives after it lands). Omitted or null = all. Kept on the pending connect until then.

Pattern: ^(now|\d{4}-\d{2}-\d{2})$
history_scope
enum<string> | null

The account's import scope: playtable_people (omitted or null, the default) takes only the conversations with a person the workspace keeps in a playtable, all every conversation. The pending connect keeps it until the account lands.

Available options:
all,
playtable_people

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
object | null
required
result
object
required
meta
object
required