Skip to content

Create a LinkedIn browser (seat)

Request

Create a LinkedIn browser "seat" bound to a sender profile. This is step 2 of connecting a LinkedIn account without the user ever logging into Grinfi:

  1. Create a sender profile — POST /flows/api/sender-profiles.

  2. Create a seat here (sender_profile_uuid). It starts in status: stopped, linkedin_account_uuid: null.

  3. Generate a Smart Login link — generate-external-access-key.

  4. Give that link to the account owner; they log into LinkedIn in the hosted cloud browser. The seat transitions to running automatically.

  5. Poll .../list until linkedin_account_uuid is populated (= connected).

Do NOT call run (start) on a freshly created, never-logged-in seat — it pushes the seat into login_issue. The backend starts it automatically once login completes.

Security
bearerAuth
Bodyapplication/jsonrequired
sender_profile_uuidstringrequired

UUID of the sender profile to link.

proxy_country_codestring

Proxy country code (e.g., US, DE).

Example:"US"
POST
/browsers/api/linkedin-browsers
curl -i -X POST \
  https://leadgen.grinfi.io/browsers/api/linkedin-browsers \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sender_profile_uuid": "string",
    "proxy_country_code": "US"
  }'

Responses

LinkedIn browser created.

Bodyapplication/json
idinteger
team_idinteger
sender_profile_uuidstring
linkedin_account_uuidstring or null
external_idstring
namestring
shared_emailsArray of strings
linkedin_automation_server_idinteger or null
linkedin_proxy_idinteger or null
proxy_country_codestring or null
custom_proxy_configArray of objects
scheduleobject(schedule)

Working hours schedule.

linkedin_loginstring or null
linkedin_passwordstring or null
ln_codestring or null
browser_ownerstring
statusstring
Enum:"running""stopped""idle""start_issue""running_issue""login_issue""initializing"
error_reasonstring or null
user_idinteger
last_start_atstring or null, (date-time)
created_atstring, (date-time)
updated_atstring, (date-time)
Response
{
  "id": 0,
  "team_id": 0,
  "sender_profile_uuid": "string",
  "linkedin_account_uuid": "string",
  "external_id": "string",
  "name": "string",
  "shared_emails": [
    "string"
  ],
  "linkedin_automation_server_id": 0,
  "linkedin_proxy_id": 0,
  "proxy_country_code": "string",
  "custom_proxy_config": [
    {}
  ],
  "schedule": {
    "timezone": "Europe/Berlin",
    "use_lead_timezone": false,
    "timeblocks": [ … ]
  },
  "linkedin_login": "string",
  "linkedin_password": "string",
  "ln_code": "string",
  "browser_owner": "string",
  "status": "running",
  "error_reason": "string",
  "user_id": 0,
  "last_start_at": "2019-08-24T14:15:22Z",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}