Skip to content

Generate a Smart Login link

Request

Mint a public, no-auth Smart Login link for a seat — the way an end user connects their LinkedIn account without a Grinfi login. Returns external_access_key and a cloud_browser_url; opening the URL provisions a hosted cloud browser where the user logs into LinkedIn. The link is valid 7 days and can be embedded in an iframe or forwarded to the account owner.

The returned cloud_browser_url uses the platform host; to serve it under this API's domain, swap the host — https://leadgen.grinfi.io/cloud-browser/public/{external_access_key} resolves to the same page. Each call overwrites the previous key for that seat; the same link survives proxy changes and re-login attempts, so don't regenerate on every failure. Do not call run before or after — the seat starts automatically when login completes.

Security
bearerAuth
Path
idintegerrequired

LinkedIn browser ID.

POST
/browsers/api/linkedin-browsers/{id}/generate-external-access-key
curl -i -X POST \
  'https://leadgen.grinfi.io/browsers/api/linkedin-browsers/{id}/generate-external-access-key' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Smart Login link.

Bodyapplication/json
external_access_keystring
Example:"lb_ak_ccdxFh94PAOJ6_jTnFPt9ct_bywcdrJo81f0sLUjGgI"
cloud_browser_urlstring, (uri)

Public 7-day login page. Swap the host to your API domain if desired.

Example:"https://leadgen.grinfi.io/cloud-browser/public/lb_ak_ccdxFh94PAOJ6_jTnFPt9ct_bywcdrJo81f0sLUjGgI"
Response
{
  "external_access_key": "lb_ak_ccdxFh94PAOJ6_jTnFPt9ct_bywcdrJo81f0sLUjGgI",
  "cloud_browser_url": "https://leadgen.grinfi.io/cloud-browser/public/lb_ak_ccdxFh94PAOJ6_jTnFPt9ct_bywcdrJo81f0sLUjGgI"
}