Naar hoofdinhoud gaan
POST
Aanmelden voor contactevents
Gebruik dit endpoint voor een Zapier REST Hook-trigger. Wil je zonder code een Zap instellen? Volg dan Tapify koppelen aan Zapier. Stuur contact.created of contact.updated mee als eventType, samen met de targetUrl die Zapier levert.
Het doeladres moet een HTTPS-URL op hooks.zapier.com zijn, zonder gebruikersnaam, wachtwoord of URL-fragment. Dit endpoint accepteert alleen Zapier-hooks.

De abonnements-ID bewaren

Het antwoord is een object met id, zonder een data-object eromheen. Bewaar deze ID om je later af te melden. Herhaal je het verzoek met dezelfde workspace, hetzelfde eventtype en dezelfde URL, dan krijg je de bestaande abonnements-ID terug. Het abonnement wordt ook gekoppeld aan de API-sleutel waarmee je het verzoek doet.

Gegevens per event

Tapify stuurt een contactobject direct naar de Zapier-hook wanneer het gekozen event plaatsvindt. Dit object bevat geen data-object of veld eventType.
  • Nieuw contact: id is de contact-ID.
  • Bijgewerkt contact: id combineert de contact-ID met het tijdstip van de wijziging. contactId bevat de oorspronkelijke contact-ID voor andere API-verzoeken.
Contactgegevens kunnen interne notities en ingediende berichten bevatten. Stuur deze alleen naar een Zapier-workflow die toegang tot die gegevens mag hebben.

Aflevering en toegang

Zorg dat je workflow herhaalde afleveringen kan verwerken. Bij tijdelijke fouten kan Tapify het opnieuw proberen, maar aflevering is niet gegarandeerd. Een 410 Gone-antwoord van Zapier verwijdert het abonnement.
Als je de API-sleutel verwijdert, worden ook de bijbehorende abonnementen verwijderd. Verbind je workflows opnieuw of meld ze opnieuw aan wanneer je een sleutel vervangt. De workspace heeft ook Teams Connect nodig om events te kunnen afleveren.

Autorisaties

Authorization
string
header
vereist

API-sleutel die is gemaakt via Instellingen → API-sleutels.

Body

application/json
eventType
enum<string>
vereist

De Tapify-contactgebeurtenis die deze Zapier-trigger gebruikt.

Beschikbare opties:
contact.created,
contact.updated
targetUrl
string<uri>
vereist

Zapier-bestemming: een HTTPS-URL op hooks.zapier.com zonder gebruikersnaam, wachtwoord of fragment.

Maximum string length: 2048
Voorbeeld:

"https://hooks.zapier.com/hooks/standard/123456/example/"

Respons

Abonnement aangemaakt of hergebruikt. Het antwoord heeft geen omsluitend data-object.

De abonnements-id, rechtstreeks teruggegeven zonder omsluitend data-object.

id
string<uuid>
vereist

Bewaar deze id om het abonnement op te zeggen.

Voorbeeld:

"1f84ece7-9acc-4abd-8ce1-925b2a5df17d"