Connect Zapier, n8n and Make with a Safina API key

Create an API key in the Safina app and use it in Zapier, n8n, Make or your own script: read calls and summaries, find and create contacts, and start a workflow after every call.

Line illustration: a key with code brackets in a chain of workflow blocks: a lightning bolt as trigger, a gear, a contact card, a handset with a green check mark and a laptop with code. Integration
David Schemm David Schemm
Updated

PrerequisiteRequirement
Safina planPro or Business
Your role in SafinaOwner or admin of the team

An API key lets an automation tool use the Safina REST API for your team. With a key, Zapier, n8n, Make or your own script can read your calls and their summaries, find and create contacts, and start a workflow after every call. The key works only for the Safina API. AI apps such as Claude or ChatGPT connect in another way: see Connect Safina to your AI assistant.

Create an API key

  1. In the Safina app, open the Profile tab and tap API keys.

Profile tab in the Safina app. In the Account section, the API keys entry is highlighted.

  1. Tap + next to Your API keys. If you have no key yet, tap Create API key below the empty list.

API keys page with the list Your API keys: a Zapier key and an n8n key. The + button next to the list title is highlighted.

  1. At the top of the New API key page, tap the title and enter a name that tells you where you use the key, for example “Zapier”.

New API key page with the name Zapier as its title, which is highlighted. Below, the choice What may this key do? with Read and write selected.

  1. Under What may this key do?, choose:

    • Read only: it can read calls, contacts and assistants.
    • Read and write: it can also create and change contacts and webhooks.

    You can’t change this later. For other access, create a new key.

  2. Under Expires after, choose when the key expires: 30 days, 90 days (preselected), 1 year or No expiration.

  3. Tap Create API key.

New API key page with Expires after set to 90 days. The Create API key button at the bottom is highlighted.

  1. The page now shows Your new API key. Tap Copy key and paste the key into your automation. The key starts with safina_api_. Safina shows the full key only once.

Page Your new API key with a demo key. The Copy key button is highlighted.

  1. Tap Done to go back to the list.

Every request sends the key in the header Authorization: Bearer <key>. The list Your API keys shows when each key was created, when it expires and when it was last used. To stop a key at once, tap the trash can next to it and confirm with Delete. Automations that use it then fail.

What an API key can do

AreaRead onlyRead and write
AssistantsList the assistants of the teamSame
CallsList calls (newest first, filters for phone number, date and duration) and get one call with summary, caller and durationSame
ContactsSearch contacts, find a contact by phone numberAlso create and update contacts
Webhooks–Subscribe to the event call.ended and delete the subscription

All routes, fields and answers are in the API reference.

Zapier

  • Safina AI app for Zapier: the app has the trigger New Call, the actions Create Contact and Update Contact, and the searches Find Call, Find Contact, Find Contact by Text and Find or Create Contact. You connect it with an API key. The app is not yet in the Zapier app directory. For access, write to info@safina.ai.
  • Webhooks by Zapier: a Catch Hook receives the call data after every call, without an API key. The steps are on Safina + Zapier.

n8n

  • Safina node for n8n: the package @sk-thinking/n8n-nodes-safina adds two nodes. Safina reads assistants and calls and creates, finds and updates contacts. It also works as a tool of the n8n AI Agent. Safina Trigger starts a workflow when a call ends and checks the signature of each event. You add the key as a credential of the type Safina API. The node is not yet in the list of n8n community nodes. For access, write to info@safina.ai. The source code is public on GitHub.
  • HTTP Request node: call any route of the API with the header Authorization: Bearer <key>.
  • Webhook node: receives the call data after every call. The steps are on Safina + n8n.

Make

Make has no Safina app yet. Use the HTTP module Make a request with the header Authorization: Bearer <key> to call the API. To start a scenario after every call, use a Custom webhook, as described on Safina + Make.

Your own script

The API address is https://api.backend.safina.ai. This example reads the five newest calls:

curl "https://api.backend.safina.ai/calls/me?limit=5" \
  -H "Authorization: Bearer safina_api_..."

Query values are JSON. A text value needs double quotes, a number does not:

curl -G "https://api.backend.safina.ai/contacts/me" \
  --data-urlencode 'search="Miller"' \
  -H "Authorization: Bearer safina_api_..."

A webhook after every call

With a read and write key, POST /webhooks with a name and a url subscribes to the event call.ended. Safina then sends one event per call when the summary is ready.

  • Set "create_signing_secret": true to sign the events. The answer holds the secret once. How to check the header X-Safina-Signature is explained in Check the Safina webhook signature.
  • Safina tries each delivery up to three times. A repeated delivery has the same event_id, so drop an event that you already processed.
  • A team can have up to 20 webhooks. Delete a subscription that you no longer need with DELETE /webhooks/{id}.
  • If the address answers 410 Gone on every attempt for three calls in a row, Safina turns the webhook off and sends one email. You can turn it on again in the app under Safina AI > Call Logging > Webhooks.

When a request fails

AnswerMeaning
401The key is wrong, deleted or expired: create a new key and update your automation. You also get 401 when the person who created the key is no longer owner or admin of the team, or when the team has no active plan.
403 api_keys_not_enabledYour account has no access to API keys yet.
403 plan_requiredThe team needs the Pro plan or higher.
403 with a read only keyThe request changes data. Use a read and write key.
409The phone number already belongs to a contact, or the team already has 20 webhooks.

Frequently asked questions

Can I use an AI connection code instead of an API key?

No. A connection code works only for AI assistants. An API key works only for the REST API.

Does a key work for all my teams?

No. A key belongs to the team that was active when you created it. For another team, switch the team in the app and create a key there.

What happens when a key expires?

Requests with it get 401. Create a new key and replace the old one in your automation.

Your Safina Team

9:41

Safina handled 51 calls this week

46

Trustworthy

4

Suspicious

1

Dangerous

Last 7 days
Filter
EM
Emma Martin 67s 15:30

Wants to discuss the offer for the new campaign and has questions about the timeline.

LS
Laura Smith 54s 14:45

Asking about the order status and when the delivery arrives.

TH
Tim Miller 34s 13:10

Schedule a meeting for the project discussion next week.

Unknown 44s 11:30

Prize promise – probably spam.

SK
Sarah King 10s 09:15

Complaint about the last order, asks for a callback.

MM
Mike Mitchell 95s Dec 13

Wants to discuss a potential collaboration.

AR
Amy Roberts 85s Dec 13

Is your colleague and wants to discuss the project.

JK
Jack Kennedy 42s Dec 12

Asking about available appointments next week.

LB
Lisa Brown 68s Dec 12

Has questions about the invoice and asks for clarification.

Calls
Safina
Contacts
Profile
9:41
Call from Emma Martin
Dec 12
11:30
67s
+12125551234

Wants to discuss the offer for the new campaign and has questions about the timeline.

Key points

  • Call back Emma Martin
  • Clarify timeline & pricing questions
Call back
Edit contact

AI Insights

Caller mood Very good

The caller was cooperative and provided the needed information.

Urgency Low

The caller can wait for a response.

Audio & Transcript

0:16

Hello, this is Safina AI, Peter's digital assistant. How can I help you?

Hi Safina, this is Emma Martin. I wanted to discuss the offer and the timeline.

Thanks, Emma. Are you mainly deciding between the Standard and Pro package for the launch?

Exactly. We need the Pro package and would like to start next month if onboarding is possible in week one.

Say goodbye to your old-fashioned voicemail.

Try Safina for free and start managing your calls intelligently.

Safina Support Bot
Safina Support Bot

Hi! 👋 I'm the Safina support assistant. Ask me anything about setup, call forwarding, plans or your account. Note: your messages are processed in line with our privacy policy.

Your messages are processed per our privacy policy