--- title: "Start a LinkedIn connect for a new sender profile" method: POST path: "/api/sender-profiles/start-linkedin-connect" tags: ["sender_profiles"] --- # Start a LinkedIn connect for a new sender profile `POST /api/sender-profiles/start-linkedin-connect` ## Request - Base URL: `https://beta.getsales.io/unibox/v1` - URL: `https://beta.getsales.io/unibox/v1/api/sender-profiles/start-linkedin-connect` - Auth: HTTP bearer and API key in header `Team-SID` Start a LinkedIn login at TEAM level: gtm mints a cloud browser and returns its one-time login link, and the sender profile is born later, from the linkedin-accounts.created delivery. Use start_sender_profile_linkedin_connect instead when the account must land on a sender profile that already exists. One browser source per call (two is a 422): proxy_country_code (the managed pool; offer only what list_sender_profile_linkedin_proxy_countries reports, a dry country is 422 proxy_pool_empty), custom_proxy_config (the team's own proxy) or vendor_profile_id (the team's own GoLogin profile, its proxy stays on it). public_link makes the link a two-day one for whoever holds the password, mailed to public_link_email when given (result.sent_to_email). history_since and history_scope bound what of the account's past is imported. Each call is a connect of its own: when gtm-api did not confirm the browser create or the link, the call answers 409 linkedin_connect_unconfirmed, not recoverable, since a repeat here makes another browser; prefer start_sender_profile_linkedin_connect, whose repeat picks up a browser made meanwhile. Other refusals read as on that tool (402 linkedin_sender_profiles_full, 402 subscription_required, 403 gtm_scope_missing). 501 while the gtm bridge is unconfigured. Contract: - MCP tool `start_new_sender_profile_linkedin_connect`, registry package `mcp.unibox/sender_profiles`, mount `unibox.sender-profiles`. - Operation `action`, response envelope `action`. - Flags: none. ## Request body - StartNewSenderProfileLinkedinConnectRequest: Request body of `start_new_sender_profile_linkedin_connect`. - `proxy_country_code` string, nullable: 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. - `custom_proxy_config` object, nullable: 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}). - `ip` string, required: Proxy host or IP. - `port` integer, required: Proxy port. - `mode` 'http' | 'socks4' | 'socks5': Proxy protocol; default http. There is no https mode: GoLogin cannot apply one. - `username` string, nullable: Proxy username; null = the proxy takes no credentials. Passed straight to gtm-api, never stored here. - `password` string, nullable: Proxy password. Passed straight to gtm-api and never stored here. - `vendor_profile_id` string, nullable: 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, nullable: 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. - `history_scope` 'all' | 'playtable_people', nullable: 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. - `public_link` boolean, nullable: Mint the login link for whoever holds the LinkedIn password: it lives two days instead of the hours a link opened right away lives. Refused with vendor_profile_id (a GoLogin profile signs in on its own session). Implied by public_link_email. - `public_link_email` string, email, nullable: gtm-api mails the public sign-in link to this address as well; the answer's sent_to_email says where it went. Implies public_link. ## Response `200` `action` success envelope. - StartNewSenderProfileLinkedinConnectResponse - `success` true, required - `operation` 'action', required - `action` string, required: kebab-case verb; matches the route segment. - `item` object, nullable, required - `result` object, required - `antidetect_browser_sid` string, required: The cloud browser minted for the login. - `connect_url` string, required: One-time link to the cloud browser. - `connect_url_expires_at` string, nullable, required: ISO 8601 UTC expiry of the link. - `sent_to_email` string, nullable, required: Where gtm-api mailed the public sign-in link (public_link_email on the call); null when nothing was mailed. - `meta` object, required - `trace_id` string, required: UUID v7; same 128-bit value as the X-Trace-Id header. - `span_id` string, required: 16 hex chars, root span of this request. - `timestamp` string, required: ISO 8601 UTC (Y-m-dTH:i:sZ), response time. - `duration_ms` integer, required: Server-side wall clock. - `team_sid` string, nullable: The team this call ran in (the token team, or the team_sid override). Null when unauthenticated; absent from pre-2026-08-20 backends. - `actor_type` string, nullable: user | agent | api_key | system. Null when unauthenticated; absent from pre-2026-08-20 backends. ## Other responses - `4XX`: MCP error envelope. `error.code` is one of validation_failed, nothing_to_update, not_found, relation_not_found, invalid_transition, limit_exceeded, payment_required, duplicate_rejected, conflict, delete_blocked, unauthorized, forbidden, rate_limited, not_implemented. - `5XX`: MCP error envelope with `error.code` internal_error or service_unavailable. --- [API](https://skmtc.dev/getsales/apis/getsales-public-contract-gs-service-unibox.md) - [All operations](https://skmtc.dev/getsales/apis/getsales-public-contract-gs-service-unibox/llms.txt) - [OpenAPI document](https://skmtc.dev/getsales/apis/getsales-public-contract-gs-service-unibox/revisions/8f1bc317897f?raw)