Unipile connector for AI agents

Tools your outreach agent reaches for on Unipile, scoped per user.

CALL ANY TOOL

68 tools for LinkedIn messaging and more in Unipile: read chats, messages, and emails, search LinkedIn people, companies, jobs, and posts, send and handle invitations, save Sales Navigator leads, manage job postings, and edit calendar events.

unipile_add_candidate_to_recruiter_pipeline

Add candidate to recruiter pipeline

Add a LinkedIn member to a Recruiter hiring project pipeline, or move an applicant or candidate between stages. Returns a success flag. Use to manage a Recruiter pipeline. Requires a LinkedIn Recruiter subscription.

Parameters

Name

Type

Required

Description

account_id

string

Required

A unique identifier. Example: mZ9tTq1xRkWJb3dLq8aXyA

action

string

Required

Action for this request. Example: addCandidateToPipeline. One of: `addCandidateToPipeline`, `addApplicantToPipeline`, `changeCandidatePipeline`.

hiring_project_id

string

Required

Hiring Project ID for this request. Example: 9f9uuKzhVHGUNo9PzbgUtQ

user_id

string

Required

The ID of the user. Example: ACoAAAcDMMQBODyLwZrRcgYhrkCafURGqva0U4E

stage

string

Optional

The default value for the stage will be uncontacted. Example: UNCONTACTED. One of: `UNCONTACTED`, `CONTACTED`, `REPLIED`.

unipile_cancel_invitation

Cancel invitation

unipile_close_job_posting

Close job posting

unipile_create_calendar_event

Create calendar event

Create an event in a calendar. Returns the new event id. Use to schedule a meeting. Use Edit Calendar Event to change one later.

Parameters

Name

Type

Required

Description

account_id

string

Required

The id of the account to use. Example: mZ9tTq1xRkWJb3dLq8aXyA

attendees

array

Required

Attendees for this request. Example: ["example"]

calendar_id

string

Required

The id of calendar receiving the event. Example: primary

end

object

Required

The end date and time of the event. Example: 2025-12-31T23:59:59.999Z

start

object

Required

The start date and time of the event. Example: 2025-01-01T00:00:00.000Z

title

string

Required

The title of the event. Example: Product sync

body

string

Optional

The body of the event. Example: example

color

string

Optional

The color of the event. `Google Calendar`: `#7986CB`, `#33B679`, `#8E24AA`, `#E67C73`, `#F6BF26`, `#F4511E`, `#039BE5`, `#616161`, `#3F51B5`, `#0B8043`, `#D50000` Example: example

conference

object

Optional

Conference for this request. Example: {"key": "value"}

guests_can_modify

boolean

Optional

If true, allow guests to modify the event. `Outlook Calendar`: Not supported, this parameter will always be false. Example: true

is_attendees_list_hidden

boolean

Optional

Is the attendees list hidden for attendees. Example: true

location

string

Optional

The location of the event. Example: Paris

notify

boolean

Optional

If true, send notifications about the event to invited attendees. `Outlook Calendar`: Not supported, this parameter will always be true. Example: true

recurrence

array

Optional

List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545. Example: ["example"]

transparency

string

Optional

The transparency of the event. `opaque` does block time on the calendar and is equivalent to setting Show me as to Busy in the Calendar UI. `transparent` does not block time on the calendar and is equivalent to setting Show me as to Available in the Calendar UI. Example: example. One of: `opaque`, `transparent`.

visibility

string

Optional

The visibility of the event. Example: example. One of: `public`, `private`.

unipile_delete_calendar_event

Delete calendar event

unipile_delete_email

Delete email

unipile_edit_calendar_event

Edit calendar event

Edit an existing calendar event. Returns a confirmation object. Use to reschedule or change an event.

Parameters

Name

Type

Required

Description

account_id

string

Required

The id of the account to use. Example: mZ9tTq1xRkWJb3dLq8aXyA

calendar_id

string

Required

The id of calendar receiving the event. Example: primary

event_id

string

Required

The id of the event to edit. Example: 0e6b0a2f3c4d5e6f7a8b9c0d

attendees

array

Optional

Attendees for this request. Example: ["example"]

body

string

Optional

The body of the event. Example: example

color

string

Optional

The color of the event. `Google Calendar`: `#7986CB`, `#33B679`, `#8E24AA`, `#E67C73`, `#F6BF26`, `#F4511E`, `#039BE5`, `#616161`, `#3F51B5`, `#0B8043`, `#D50000` Example: example

conference

object

Optional

Conference for this request. Example: {"key": "value"}

end

object

Optional

The end date and time of the event. Example: 2025-12-31T23:59:59.999Z

guests_can_modify

boolean

Optional

If true, allow guests to modify the event. `Outlook Calendar`: Not supported, this parameter will always be false. Example: true

is_attendees_list_hidden

boolean

Optional

Is the attendees list hidden for attendees. Example: true

location

string

Optional

The location of the event. Example: Paris

notify

boolean

Optional

If true, send notifications about the event update to invited attendees. Example: true

recurrence

array

Optional

List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545. Example: ["example"]

start

object

Optional

The start date and time of the event. Example: 2025-01-01T00:00:00.000Z

title

string

Optional

The title of the event. Example: Product sync

transparency

string

Optional

visibility

string

Optional

The visibility of the event. Example: example. One of: `public`, `private`.

unipile_get_account

Get account

unipile_get_calendar

Get calendar

unipile_get_chat

Get chat

unipile_get_email_folder

Get email folder

unipile_get_inmail_balance

Get inmail balance

unipile_get_job_posting

Get job posting

unipile_get_linkedin_search_parameters

Get linkedin search parameters

unipile_get_own_profile

Get own profile

unipile_handle_received_invitation

Handle received invitation

unipile_list_accounts

List accounts

unipile_list_attendee_messages

List attendee messages

unipile_list_calendars

List calendars

unipile_list_chats

List chats

unipile_list_emails

List emails

List emails of a connected email account, optionally filtered by folder, sender, recipient or date. Returns email id, subject, sender, recipients, date and read state, with a cursor for the next page. Use to browse a mailbox. Use Get Email to read the full message.

Parameters

Name

Type

Required

Description

account_id

string

Required

A filter to target items related to a certain account. Example: mZ9tTq1xRkWJb3dLq8aXyA

after

string

Optional

A filter to target items created after the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ). Example: 2025-12-31T23:59:59.999Z

any_email

string

Optional

A filter to target items sent to or received from a comma-separated list of email addresses. Example: jane@example.com

before

string

Optional

A filter to target items created before the datetime (exclusive). Must be an ISO 8601 UTC datetime (YYYY-MM-DDTHH:MM:SS.sssZ). Example: 2025-12-31T23:59:59.999Z

cursor

string

Optional

A cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved. Example: eyJwYWdlIjoyfQ

exclude_folders

string

Optional

A filter to exclude items from a comma-separated list of folder provider_id ( ignored if folder parameter is used ). Example: example

folder

string

Optional

A filter to target items related to a certain folder provider_id. Example: example

from

string

Optional

A filter to target items related to a certain sender. Example: example

include_headers

boolean

Optional

Include the email headers in the response. `meta_only` must be false. Example: true

limit

integer

Optional

A limit for the number of items returned in the response. The value can be set between 1 and 250. Example: 100

message_id

string

Optional

A filter to target items by message_id. Example: kLm2Pq8RTu6VwXyZ1aBcDe

meta_only

boolean

Optional

Speed up the response by only returning the email metadata, excluding the body and attachments metadata. Example: true

string

Optional

Free-text search applied to subject and body at the same time. Microsoft: requests combining search with from, to, any_email, before, after, thread_id, message_id or exclude_folders are rejected with invalid_request. IMAP: can be slow, only available within one folder, specified with folder or role, before and after are evaluated at day granularity, support depends on the IMAP server. IMAP requests combining search with any_email, exclude_folders, thread_id, multiple from values or multiple to values are rejected with invalid_request. Example: example

thread_id

string

Optional

A filter to target items by thread identifier. Example: 9f9uuKzhVHGUNo9PzbgUtQ

string

Optional

A filter to target items related to a certain recipient, either in the to, cc or bcc field. Example: example

unipile_list_hiring_projects

List hiring projects

unipile_list_job_applicants

List job applicants

List the users who applied to a LinkedIn job posting. Returns applicant id, name, headline and application date, with a cursor and paging information. Use to review applicants. Use Get Job Applicant for one applicant.

Parameters

Name

Type

Required

Description

account_id

string

Required

The ID of the account to trigger the request from. Example: mZ9tTq1xRkWJb3dLq8aXyA

string

Required

The ID of the job offer. Example: mZ9tTq1xRkWJb3dLq8aXyA

cursor

string

Optional

exclude_degree

array

Optional

Linkedin Recruiter native filter : DEGREES (excluded). Example: ["example"]

include_archived

boolean

Optional

Whether the results should include archived applicants. Recruiter only. Example: true

include_degree

array

Optional

Linkedin Recruiter native filter : DEGREES (included). Example: ["example"]

keywords

string

Optional

Filter results with keywords. Example: product manager

limit

integer

Optional

A limit for the number of items returned in the response. The value can be set between 1 and 100. Example: 25

max_years_in_company

number

Optional

Linkedin Recruiter native filter : YEARS IN CURRENT COMPANY. Example: 10

max_years_in_position

number

Optional

Linkedin Recruiter native filter : YEARS IN CURRENT POSITION. Example: 10

max_years_of_experience

number

Optional

Linkedin Recruiter native filter : YEARS OF EXPERIENCE. Example: 10

min_years_in_company

number

Optional

Linkedin Recruiter native filter : YEARS IN CURRENT COMPANY. Example: 10

min_years_in_position

number

Optional

Linkedin Recruiter native filter : YEARS IN CURRENT POSITION. Example: 10

min_years_of_experience

number

Optional

Linkedin Recruiter native filter : YEARS OF EXPERIENCE. Example: 10

ratings

string

Optional

One or more ratings (UNRATED, GOOD_FIT, MAYBE, NOT_A_FIT) separated by commas. Classic only. Example: example

service

string

Optional

The Linkedin service the job posting depends on. Default is classic. Example: CLASSIC. One of: `CLASSIC`, `RECRUITER`.

sort_by

string

Optional

The sorting rule for applicants. Recruiter only. Example: relevance. One of: `relevance`, `alphabetical`, `newest_first`, `screening_requirements`.

unipile_list_post_comments

List post comments

unipile_list_user_comments

List user comments

unipile_publish_job_posting

Publish job posting

unipile_search_linkedin_companies

Search linkedin companies

unipile_search_linkedin_people

Search linkedin people

Search people with the LinkedIn Classic search, using keywords and filter ids. Returns matching profiles with name, headline, location and profile url, plus paging and a cursor. Use to find prospects or candidates. Get filter ids from Get LinkedIn Search Parameters. Read-only despite using POST.

Parameters

Name

Type

Required

Description

account_id

string

Required

The ID of the account to trigger the request from. Example: mZ9tTq1xRkWJb3dLq8aXyA

advanced_keywords

object

Optional

Advanced Keywords for this request. Example: {"key": "value"}

company

array

Optional

The ID of the parameter. Use type COMPANY on the List search parameters route to find out the right ID. Linkedin native filter : CURRENT COMPANY. Example: ["example"]

connections_of

array

Optional

The ID of the parameter. Use type CONNECTIONS on the List search parameters route to find out the right ID. Linkedin native filter : CONNECTIONS OF. Example: ["example"]

cursor

string

Optional

followers_of

array

Optional

The ID of the parameter. Use type PEOPLE on the List search parameters route to find out the right ID. Linkedin native filter : FOLLOWERS OF. Example: ["example"]

industry

array

Optional

The ID of the parameter. Use type INDUSTRY on the List search parameters route to find out the right ID. Linkedin native filter : INDUSTRY. Example: ["example"]

keywords

string

Optional

Linkedin native filter : KEYWORDS. Example: product manager

limit

integer

Optional

The maximum number of items to return. Sales Navigator and Recruiter support up to 100 results. For Classic searches, People and Companies are limited to 10 results per page, while Jobs are limited to 50. Post searches default to 3 results, matching LinkedIn's UI, but the limit can technically be increased up to 49. Example: 25

location

array

Optional

The ID of the parameter. Use type LOCATION on the List search parameters route to find out the right ID. Linkedin native filter : LOCATIONS. Example: Paris

network_distance

array

Optional

First, second or third+ degree. Linkedin native filter : CONNECTIONS. Example: ["example"]

open_to

array

Optional

Linkedin native filter : OPEN TO. Example: ["example"]

past_company

array

Optional

The ID of the parameter. Use type COMPANY on the List search parameters route to find out the right ID. Linkedin native filter : PAST COMPANY. Example: ["example"]

profile_language

array

Optional

ISO 639-1 language code. Linkedin native filter : PROFILE LANGUAGE. Example: ["example"]

school

array

Optional

The ID of the parameter. Use type SCHOOL on the List search parameters route to find out the right ID. Linkedin native filter : SCHOOL. Example: ["example"]

service

array

Optional

The ID of the parameter. Use type SERVICE on the List search parameters route to find out the right ID. Linkedin native filter : SERVICE CATEGORIES. Example: ["example"]

unipile_send_invitation

Send invitation

unipile_update_chat

Update chat

For more tools, view docs.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Unipile tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["unipile"], toolNames: [
    "unipile_search_linkedin_people",
    "unipile_get_user_profile",
    "unipile_send_invitation"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Find heads of RevOps at Series B SaaS companies and invite the top 5" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["unipile"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Find heads of RevOps at Series B SaaS companies and invite the top 5" }],
  tools,
});

// Execute the tool call with the user's vaulted Unipile API key
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["unipile"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Find heads of RevOps at Series B SaaS companies and invite the top 5" }],
  tools,
});

// Tool call runs with the user's vaulted Unipile API key
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["unipile"] }, pageSize: 100,
});

const agent = new Agent({
  name: "outreach_agent",
  model: "gemini-2.5-pro",
  instruction: "Unipile tools scoped to this user",
  tools,
});

await agent.run("Find heads of RevOps at Series B SaaS companies and invite the top 5");

Try these prompts

Copy any prompt into your agent. Each maps directly to a Unipile tool. Click to copy, paste into your agent, done.

LinkedIn prospecting

Copy the prompt

Copied

Search LinkedIn for heads of RevOps at Series B SaaS companies in New York.

Copy the prompt

Copied

Send a connection invitation to this profile with a short note about our webinar.

Copy the prompt

Copied

Save Priya Shah as a lead in my Sales Navigator Q4 list.

Inbox

Copy the prompt

Copied

List my unread LinkedIn and WhatsApp chats from today.

Copy the prompt

Copied

Show the last 10 messages in my chat with Alex from Globex.

Copy the prompt

Copied

List emails from acme.com in my inbox this week.

Hiring and calendar

Copy the prompt

Copied

List applicants to our Senior Backend Engineer job posting.

Copy the prompt

Copied

Add this candidate to the Platform Hiring Recruiter project.

Copy the prompt

Copied

Create a calendar event with Priya on Thursday at 3pm.

SEE HOW AUTH WORKS

Each user connects their own Unipile API key once, and Scalekit sends it with every call. API keys stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

Unipile

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

Unipile

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

Unipile

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

Unipile

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other communication and sales connectors.

GTM and RevOps Teams

Outbound prospecting agent

Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.

GTM and RevOps Teams

CRM AI agent

Reads the Granola transcript after every call, extracts next steps and updates the HubSpot record, drafts the follow-up in Gmail, and confirms in Slack, all on the rep's own delegated OAuth.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared Unipile API key looks fine in a demo. In production every invitation and message looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared key
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Unipile today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Unipile as the user or through a shared API key?

As the user. Each user connects their own Unipile API key once, and Scalekit sends it with every call. Audit logs attribute every invitation, message, and lead save to that user, not a shared service account.

Where is the Unipile API key stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. To rotate it, the user reconnects with a new API key. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in Unipile?

Yes. Filter by tool name in listScopedTools to expose only what you want, for example the search and list tools without unipile_send_invitation or unipile_delete_chat. Scalekit also enforces scope checks before every API call.

What happens when a user revokes Unipile access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Which accounts does the agent reach through Unipile?

The messaging, email, and calendar accounts connected to the user's Unipile workspace, such as LinkedIn, WhatsApp, Gmail, and Microsoft Outlook. unipile_list_accounts returns them, and each tool takes an account id to pick which one to act on.