Zapier
The official Pinlyx app for Zapier starts a Zap when something happens in your CRM, and lets a Zap create or change contacts, deals and tasks, or send a message. It runs on the public API and webhooks, so it sees exactly what your API key allows.
Set it up
Section titled “Set it up”-
In the Pinlyx app, open Settings › Developers and create an API key (see Authentication). Give it at least
contacts:readandwebhooks:write, plus the scopes of the actions you plan to use, for exampledeals:writeortelegram:send. API keys are part of the Business plan. -
Open Integrations › Zapier in the panel and click Join the private app. Accept the invite on Zapier.
-
In a Zap, choose Pinlyx as the app and connect an account. Paste the key into API Key.
-
Leave Workspace ID empty, unless you belong to more than one workspace and want the connection to act inside a specific one.
Each trigger subscribes a webhook endpoint for you when the Zap is turned on and removes it when the Zap is turned off. Those endpoints count toward the 20 webhook endpoints of your account.
Triggers
Section titled “Triggers”| Trigger | Fires when |
|---|---|
| New Contact | A contact is created |
| Updated Contact | A contact’s fields change |
| Contact Moved to New Pipeline Stage | A contact moves between columns on a pipeline board |
| New Deal | A deal is opened |
| Deal Stage Changed | A deal moves between stages |
| Deal Won | A deal is closed as won |
| Deal Lost | A deal is closed as lost |
| New Task | A task is created |
| Task Completed | A task is marked done |
| New Inbound Message | A message arrives on any connected channel |
| Message Sent | A message is delivered to a contact from your CRM |
| Sequence Completed | A sequence finishes |
| Outreach Reply Received | A campaign recipient replies |
| New Invoice | An invoice is issued |
| Invoice Paid | An invoice is settled |
Actions
Section titled “Actions”| Action | What it does |
|---|---|
| Create Contact | Adds a contact with name, email, phone, username, external ID, company, stage, pipeline column, tags, lead score, location and notes |
| Update Contact | Changes fields on an existing contact |
| Tag Contact | Adds a tag to a contact |
| Remove Tag From Contact | Removes a tag from a contact |
| Set Lead Score | Sets a contact’s lead score |
| Assign Contact to Team Member | Assigns a contact to a workspace member |
| Create Deal | Opens a deal with title, contact, value, currency, stage, probability, expected close date and notes |
| Move Deal to Stage | Moves a deal to another stage |
| Create Task | Creates a task |
| Change Task Status | Changes a task’s status |
| Send Telegram Message | Queues a Telegram message from one of your accounts |
| Reply in Social Conversation | Replies inside a social inbox conversation |
| Send X Direct Message | Sends an X direct message |
Searches
Section titled “Searches”Find Contact, Find Deal and Find Task look up an existing record. Each one is also offered as a find-or-create step (Find or Create Contact, Find or Create Deal, Find or Create Task), which creates the record only when the search finds nothing.
Good to know
Section titled “Good to know”- An action fails with a permission error when the key lacks its scope. Add the scope to a new key and reconnect the account.
- A Zap that writes many records counts against the key’s per-minute rate limit.
- Without the Zapier app, you can still use Webhooks by Zapier with a Pinlyx webhook endpoint as the trigger.