Kontakte

Kontaktprofile und eigene Felder verwalten, gesammelt oder einzeln.

Basis-URLhttps://api.emailit.com/v2Authentifizierung Fehler Rate Limits

POST/contacts
GET/contacts/{id}
POST/contacts/{id}
GET/contacts
POST/contacts/bulk
POST/contacts/{id}/tags
DEL/contacts/{id}/tags
GET/contacts/tags
POST/contacts/{id}/score
GET/contacts/export
DEL/contacts/{id}

Kontakt erstellen

Erstellt einen Kontakt und meldet ihn optional bei Kontaktlisten an.

POST/contacts

Erfordert einen API-Schlüssel mit dem Scope full. E-Mail-Adressen sind pro Workspace eindeutig und werden in Kleinbuchstaben gespeichert; das Erstellen eines bereits vorhandenen Kontakts gibt 409 mit dem vorhandenen Kontakt in existing zurück. Löst contact.created aus und für jede Kontaktliste subscriber.created. Siehe Kontakte.

Body-Parameter

emailstringerforderlich

Die E-Mail-Adresse des Kontakts.

first_namestring

Der Vorname.

last_namestring

Der Nachname.

custom_fieldsobject

Werte nach Schlüssel des eigenen Felds, etwa {"company": "Analytical Engines"}. Werte für Datumsfelder müssen das Format YYYY-MM-DD haben. Schlüssel, die zu keinem eigenen Feld passen, werden unverändert gespeichert.

audiencesstring[]

IDs der Kontaktlisten (aud_…), bei denen der Kontakt angemeldet wird. IDs, die im Workspace nicht existieren, werden übersprungen.

tagsstring[]

Bis zu 50 Tags, gespeichert in Kleinbuchstaben.

scoreintegerStandardwert: 0

Der anfängliche Lead-Score des Kontakts.

unsubscribedbooleanStandardwert: false

true erstellt den Kontakt als abgemeldet. Kampagnen überspringen abgemeldete Kontakte; ihre Mitgliedschaften in Kontaktlisten beginnen als abgemeldet.

Rückgabe

Gibt 201 mit dem Kontakt-Objekt zurück. Hier listet audiences jede Kontaktliste mit id, name und dem Status subscribed auf. Alle Felder finden Sie unter Kontakt abrufen.

Gibt 422 mit usage zurück, wenn eine Kontaktliste das Abonnentenlimit Ihres Tarifs erreicht hat. In diesem Fall wird kein Kontakt erstellt.

POST/contacts

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const contact = await emailit.contacts.create({
  email: 'ada@example.com',
  first_name: 'Ada',
  last_name: 'Lovelace',
});

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

contact = client.contacts.create({
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
})

PHP

$emailit = Emailit::client('your_api_key');

$contact = $emailit->contacts()->create([
  'email' => 'ada@example.com',
  'first_name' => 'Ada',
  'last_name' => 'Lovelace',
]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

contact = client.contacts.create(
  email: "ada@example.com",
  first_name: "Ada",
  last_name: "Lovelace"
)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

contact, err := client.Contacts.Create(&emailit.CreateContactRequest{
  Email:     "ada@example.com",
  FirstName: "Ada",
  LastName:  "Lovelace",
})

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let contact = emailit.contacts.create(
  emailit::types::CreateContactParams::new("ada@example.com")
    .with_first_name("Ada")
    .with_last_name("Lovelace")
).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject contact = emailit.contacts().create(
  ContactCreateParams.builder()
    .setEmail("ada@example.com")
    .setFirstName("Ada")
    .setLastName("Lovelace")
    .build()
);

using Emailit;

var emailit = new EmailitClient("your_api_key");

var contact = emailit.Contacts.Create(new ContactCreateOptions {
  Email = "ada@example.com",
  FirstName = "Ada",
  LastName = "Lovelace",
});

PHP

use Emailit\Laravel\Facades\Emailit;

$contact = Emailit::contacts()->create([
  'email' => 'ada@example.com',
  'first_name' => 'Ada',
  'last_name' => 'Lovelace',
]);

Terminal

curl -X POST https://api.emailit.com/v2/contacts \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Analytical Engines", "plan": "pro" },
    "audiences": ["aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2"]
  }'

JSON

{
  "object": "contact",
  "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines",
    "plan": "pro"
  },
  "unsubscribed": false,
  "audiences": [
    {
      "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "name": "Newsletter",
      "subscribed": true
    }
  ],
  "created_at": "2026-10-01T10:20:31.704113Z",
  "updated_at": "2026-10-01T10:20:31.704113Z"
}

JSON

{
  "error": "Custom field \"Birthday\" must be a date in YYYY-MM-DD format"
}

JSON

{
  "error": "Contact with this email already exists",
  "existing": {
    "object": "contact",
    "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": {
      "company": "Analytical Engines",
      "plan": "pro"
    },
    "unsubscribed": false,
    "audiences": [
      {
        "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
        "name": "Newsletter",
        "subscribed": true
      }
    ],
    "created_at": "2026-10-01T10:20:31.704113Z",
    "updated_at": "2026-10-01T10:20:31.704113Z"
  }
}

JSON

{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": {
    "used": 50000,
    "limit": 50000,
    "plan": "pro"
  }
}

Kontakt abrufen

Ruft einen Kontakt mit seinen eigenen Feldern und Mitgliedschaften in Kontaktlisten ab.

GET/contacts/{id}

Erfordert einen API-Schlüssel mit dem Scope full.

Pfadparameter

idstringerforderlich

Die ID des Kontakts (con_…) oder seine E-Mail-Adresse, URL-kodiert.

Rückgabe

Gibt das Kontakt-Objekt zurück.

objectstring

Immer contact.

idstring

Die ID des Kontakts.

emailstring

Die E-Mail-Adresse in Kleinbuchstaben.

first_namestring | null

Der Vorname.

last_namestring | null

Der Nachname.

custom_fieldsobject

Werte eigener Felder nach Schlüssel. {}, wenn keine vorhanden sind.

unsubscribedboolean

true, wenn sich der Kontakt von allen Kampagnen abgemeldet hat.

tagsstring[]

Die Tags des Kontakts, in Kleinbuchstaben und sortiert.

scoreinteger

Der Lead-Score des Kontakts.

audiencesobject[]

Die Kontaktlisten, zu denen der Kontakt gehört, jeweils mit id, name und einem Objekt subscriber: id (sub_…), subscribed, subscribed_at, unsubscribed_at, created_at und updated_at.

created_atstring

Zeitpunkt der Erstellung des Kontakts.

updated_atstring

Zeitpunkt der letzten Änderung des Kontakts.

GET/contacts/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const contact = await emailit.contacts.get('con_4K9kQdrXth7am0TPKvPrR5yd2oo');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

contact = client.contacts.get("con_4K9kQdrXth7am0TPKvPrR5yd2oo")

PHP

$emailit = Emailit::client('your_api_key');

$contact = $emailit->contacts()->get('con_4K9kQdrXth7am0TPKvPrR5yd2oo');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

contact = client.contacts.get("con_4K9kQdrXth7am0TPKvPrR5yd2oo")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

contact, err := client.Contacts.Get("con_4K9kQdrXth7am0TPKvPrR5yd2oo")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let contact = emailit.contacts.get("con_4K9kQdrXth7am0TPKvPrR5yd2oo").await?;

Java

import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject contact = emailit.contacts().get("con_4K9kQdrXth7am0TPKvPrR5yd2oo");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var contact = emailit.Contacts.Get("con_4K9kQdrXth7am0TPKvPrR5yd2oo");

PHP

use Emailit\Laravel\Facades\Emailit;

$contact = Emailit::contacts()->get('con_4K9kQdrXth7am0TPKvPrR5yd2oo');

Terminal

curl https://api.emailit.com/v2/contacts/con_4K9kQdrXth7am0TPKvPrR5yd2oo \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "contact",
  "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines",
    "plan": "pro"
  },
  "unsubscribed": false,
  "audiences": [
    {
      "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "name": "Newsletter",
      "subscriber": {
        "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
        "subscribed": true,
        "subscribed_at": "2026-10-01T10:20:31.000000Z",
        "unsubscribed_at": null,
        "created_at": "2026-10-01T10:20:31.000000Z",
        "updated_at": "2026-10-01T10:20:31.000000Z"
      }
    }
  ],
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-01T10:20:31.000000Z"
}

JSON

{
  "error": "Contact not found"
}

Kontakt aktualisieren

Aktualisiert einen Kontakt. Nur die gesendeten Felder ändern sich.

POST/contacts/{id}

Erfordert einen API-Schlüssel mit dem Scope full. Löst contact.updated aus, mit den vorherigen Werten geänderter Felder in previous. Eine Änderung von audiences löst zusätzlich subscriber.created und subscriber.deleted für die hinzugefügten und entfernten Mitgliedschaften aus.

Pfadparameter

idstringerforderlich

Die ID des Kontakts (con_…) oder seine E-Mail-Adresse, URL-kodiert.

Body-Parameter

emailstring

Eine neue E-Mail-Adresse. Darf keinem anderen Kontakt gehören.

first_namestring

Der Vorname.

last_namestring

Der Nachname.

custom_fieldsobject

Werte eigener Felder nach Schlüssel. Ersetzt alle eigenen Felder des Kontakts; geben Sie also auch die an, die Sie behalten möchten.

unsubscribedboolean

true meldet den Kontakt von allen Kampagnen ab, false meldet ihn erneut an. Bestehende Mitgliedschaften in Kontaktlisten behalten ihren eigenen Status.

tagsstring[]

Ersetzt alle Tags des Kontakts. [] entfernt alle.

add_tagsstring[]

Hinzuzufügende Tags; die übrigen bleiben erhalten.

remove_tagsstring[]

Zu entfernende Tags.

scoreinteger

Setzt den Lead-Score. Um Punkte zu addieren oder abzuziehen, verwenden Sie Lead-Score eines Kontakts ändern.

audiencesstring[]

Die vollständige Liste der IDs der Kontaktlisten, zu denen der Kontakt gehören soll. Der Kontakt wird den Kontaktlisten hinzugefügt, in denen er noch nicht ist, und aus den Kontaktlisten entfernt, die nicht in Ihrer Liste stehen. Senden Sie [], um ihn aus allen Kontaktlisten zu entfernen. Um eine einzelne Kontaktliste hinzuzufügen oder zu entfernen, ohne alle aufzuzählen, nutzen Sie Abonnent hinzufügen oder Abonnent löschen.

Rückgabe

Gibt den aktualisierten Kontakt im selben Format wie Kontakt abrufen zurück. Eine Anfrage ohne eines dieser Felder gibt 400 zurück.

POST/contacts/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const contact = await emailit.contacts.update('con_4K9kQdrXth7am0TPKvPrR5yd2oo', {
  first_name: 'Augusta',
});

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

contact = client.contacts.update("con_4K9kQdrXth7am0TPKvPrR5yd2oo", {
  "first_name": "Augusta",
})

PHP

$emailit = Emailit::client('your_api_key');

$contact = $emailit->contacts()->update('con_4K9kQdrXth7am0TPKvPrR5yd2oo', [
  'first_name' => 'Augusta',
]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

contact = client.contacts.update("con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  first_name: "Augusta"
)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

contact, err := client.Contacts.Update("con_4K9kQdrXth7am0TPKvPrR5yd2oo", &emailit.UpdateContactRequest{
  FirstName: "Augusta",
})

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let contact = emailit.contacts.update("con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  emailit::types::UpdateContactParams {
    first_name: Some("Augusta".into()),
    ..Default::default()
  }
).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject contact = emailit.contacts().update("con_4K9kQdrXth7am0TPKvPrR5yd2oo", 
  ContactUpdateParams.builder()
    .setFirstName("Augusta")
    .build()
);

using Emailit;

var emailit = new EmailitClient("your_api_key");

var contact = emailit.Contacts.Update("con_4K9kQdrXth7am0TPKvPrR5yd2oo", new ContactUpdateOptions {
  FirstName = "Augusta",
});

PHP

use Emailit\Laravel\Facades\Emailit;

$contact = Emailit::contacts()->update('con_4K9kQdrXth7am0TPKvPrR5yd2oo', [
  'first_name' => 'Augusta',
]);

Terminal

curl -X POST https://api.emailit.com/v2/contacts/con_4K9kQdrXth7am0TPKvPrR5yd2oo \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Augusta"}'

Terminal

curl -X POST https://api.emailit.com/v2/contacts/ada%40example.com \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_fields": { "company": "Analytical Engines", "plan": "business" },
    "audiences": ["aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"]
  }'

JSON

{
  "object": "contact",
  "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Augusta",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines",
    "plan": "pro"
  },
  "unsubscribed": false,
  "audiences": [
    {
      "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "name": "Newsletter",
      "subscriber": {
        "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
        "subscribed": true,
        "subscribed_at": "2026-10-01T10:20:31.000000Z",
        "unsubscribed_at": null,
        "created_at": "2026-10-01T10:20:31.000000Z",
        "updated_at": "2026-10-01T10:20:31.000000Z"
      }
    }
  ],
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-02T09:03:17.000000Z"
}

JSON

{
  "error": "No valid fields provided for update. Provide at least one of: email, first_name, last_name, custom_fields, unsubscribed, audiences"
}

JSON

{
  "error": "Contact not found"
}

JSON

{
  "error": "Another contact with this email already exists"
}

Kontakte auflisten

Gibt eine Seite mit Kontakten zurück, die neuesten zuerst.

GET/contacts

Erfordert einen API-Schlüssel mit dem Scope full. Mit denselben Parametern laden Sie über Kontakte exportieren alle Treffer als Datei herunter.

Query-Parameter

pageintegerStandardwert: 1

Die abzurufende Seite.

limitintegerStandardwert: 10

Kontakte pro Seite, von 1 bis 100.

searchstring

Abgleich mit E-Mail-Adresse, Vor- oder Nachname, ohne Beachtung der Groß-/Kleinschreibung. q funktioniert ebenfalls.

audience_idstring

Nur Kontakte in dieser Kontaktliste (aud_…).

unsubscribedboolean

true oder false. Nur Kontakte mit diesem Abmeldestatus.

filter[tag]string

Nur Kontakte mit diesem Tag. Trennen Sie mehrere Tags durch Kommas, um Kontakte mit einem davon zu erhalten. tag funktioniert ebenfalls.

filter[score][gte], filter[score][lte]integer

Nur Kontakte mit einem Lead-Score von mindestens oder höchstens diesem Wert.

sortstringStandardwert: created_at

email, first_name, last_name, name, audiences, score, created_at oder updated_at.

orderstringStandardwert: desc

asc oder desc. Bei diesem Endpunkt ist order die Sortierrichtung, nicht der Sortierschlüssel.

matchstringStandardwert: all

all oder or. Wie die Filter unten kombiniert werden.

Filter

Fügen Sie Filter als key.condition=value hinzu, zum Beispiel email.ends_with=@acme.com oder custom_fields.plan.exact=pro. Siehe Filtern und Sortieren.

Schlüssel	Typ	Hinweise
`email`	string
`first_name`	string
`last_name`	string
`name`	string	Vor- und Nachname, durch ein Leerzeichen verbunden.
`audiences`	string	Der alphabetisch erste Name einer Kontaktliste des Kontakts.
`unsubscribed`	boolean
`created_at`	date
`updated_at`	date
`audience_id`	string	Nur `exact` und `not_exact`. Der Wert ist die ID einer Kontaktliste.
`custom_fields.<key>`	string	Ersetzen Sie `<key>` durch den Schlüssel eines eigenen Felds. Werte werden als Text verglichen.

Die älteren Parameter filter[audience_id], filter[unsubscribed] und filter[custom_fields][<key>] funktionieren weiterhin.

Rückgabe

dataobject[]

Die Kontakte auf dieser Seite, jeweils mit audiences als id, name und subscribed. Siehe Kontakt abrufen.

total_recordsinteger

Die Anzahl der passenden Kontakte über alle Seiten hinweg.

next_page_urlstring | null

Pfad der nächsten Seite mit Ihren Filtern oder null. Siehe Paginierung.

previous_page_urlstring | null

Pfad der vorherigen Seite oder null.

GET/contacts

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const contacts = await emailit.contacts.list();

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

contacts = client.contacts.list()

PHP

$emailit = Emailit::client('your_api_key');

$contacts = $emailit->contacts()->list();

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

contacts = client.contacts.list

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

contacts, err := client.Contacts.List(nil)

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let contacts = emailit.contacts.list(None).await?;

Java

import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject contacts = emailit.contacts().list();

using Emailit;

var emailit = new EmailitClient("your_api_key");

var contacts = emailit.Contacts.List();

PHP

use Emailit\Laravel\Facades\Emailit;

$contacts = Emailit::contacts()->list();

Terminal

curl https://api.emailit.com/v2/contacts \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Terminal

curl -G https://api.emailit.com/v2/contacts \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2" \
  --data-urlencode "custom_fields.plan.exact=pro" \
  --data-urlencode "sort=email" \
  --data-urlencode "order=asc" \
  --data-urlencode "limit=100"

JSON

{
  "data": [
    {
      "object": "contact",
      "id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines",
        "plan": "pro"
      },
      "unsubscribed": false,
      "audiences": [
        {
          "id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
          "name": "Newsletter",
          "subscribed": true
        }
      ],
      "created_at": "2026-10-01T10:20:31.704113Z",
      "updated_at": "2026-10-01T10:20:31.704113Z"
    },
    {
      "object": "contact",
      "id": "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7",
      "email": "grace@example.com",
      "first_name": "Grace",
      "last_name": "Hopper",
      "custom_fields": {},
      "unsubscribed": true,
      "audiences": [],
      "created_at": "2026-09-28T07:55:02.118342Z",
      "updated_at": "2026-09-30T18:11:40.902215Z"
    }
  ],
  "total_records": 2,
  "next_page_url": null,
  "previous_page_url": null
}

Kontakte gesammelt aktualisieren

Führt eine Aktion für bis zu 100 Kontakte in einer einzigen Anfrage aus.

POST/contacts/bulk

Erfordert einen API-Schlüssel mit dem Scope full. Jede ID muss zu einem Kontakt im Workspace gehören, sonst wird nichts geändert und die Antwort listet die fehlenden IDs in missing auf. Jeder Kontakt löst dieselben Events aus wie bei den Endpunkten für einzelne Kontakte. Erreicht die Kontaktliste während add_to_audience das Abonnentenlimit Ihres Tarifs, bricht die Anfrage mit 422 ab; die bis dahin verarbeiteten Kontakte bleiben hinzugefügt.

Aktion	Was passiert
`delete`	Löscht die Kontakte und ihre Mitgliedschaften in Kontaktlisten, wie Kontakt löschen.
`add_to_audience`	Fügt die Kontakte der Kontaktliste `audience_id` hinzu. Kontakte, die bereits darin sind, bleiben unverändert.
`remove_from_audience`	Entfernt die Kontakte aus der Kontaktliste `audience_id`.
`unsubscribe`	Setzt `unsubscribed` auf `true`, sodass Kampagnen die Kontakte überspringen.
`resubscribe`	Setzt `unsubscribed` auf `false`.

Body-Parameter

actionstringerforderlich

delete, add_to_audience, remove_from_audience, unsubscribe oder resubscribe.

idsstring[]erforderlich

Kontakt-IDs (con_…), von 1 bis 100. E-Mail-Adressen werden hier nicht akzeptiert. Duplikate werden ignoriert.

audience_idstring

Die ID der Kontaktliste. Erforderlich für add_to_audience und remove_from_audience.

Rückgabe

objectstring

Immer contact_bulk.

actionstring

Die ausgeführte Aktion.

processedinteger

Wie viele Kontakte verarbeitet wurden.

idsstring[]

Die IDs der verarbeiteten Kontakte.

POST/contacts/bulk

JavaScript

const response = await fetch('https://api.emailit.com/v2/contacts/bulk', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}),
});
const result = await response.json();

Python

import requests

response = requests.post(
  "https://api.emailit.com/v2/contacts/bulk",
  headers={"Authorization": "Bearer your_api_key"},
  json={"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}
)
result = response.json()

PHP

$ch = curl_init('https://api.emailit.com/v2/contacts/bulk');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer your_api_key',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode(['action' => 'add_to_audience', 'ids' => ['con_4K9kQdrXth7am0TPKvPrR5yd2oo', 'con_4KiXIs4xLTcJIAHnKJaLcnMZYh7'], 'audience_id' => 'aud_4KOlh9t2uw5od4qypqCtyrZyDq2']),
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

Ruby

require "net/http"
require "json"

uri = URI("https://api.emailit.com/v2/contacts/bulk")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer your_api_key"
req["Content-Type"] = "application/json"
req.body = { action: "add_to_audience", ids: ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], audience_id: "aud_4KOlh9t2uw5od4qypqCtyrZyDq2" }.to_json
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
result = JSON.parse(http.request(req).body)

payload := strings.NewReader(`{"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}`)
req, _ := http.NewRequest("POST", "https://api.emailit.com/v2/contacts/bulk", payload)
req.Header.Set("Authorization", "Bearer your_api_key")
req.Header.Set("Content-Type", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil {
  return err
}
defer resp.Body.Close()

Rust

let response = reqwest::Client::new()
    .post("https://api.emailit.com/v2/contacts/bulk")
    .bearer_auth("your_api_key")
    .json(&serde_json::json!({"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}))
    .send()
    .await?;

Java

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.emailit.com/v2/contacts/bulk"))
  .header("Authorization", "Bearer your_api_key")
  .header("Content-Type", "application/json")
  .POST(HttpRequest.BodyPublishers.ofString("{\"action\": \"add_to_audience\", \"ids\": [\"con_4K9kQdrXth7am0TPKvPrR5yd2oo\", \"con_4KiXIs4xLTcJIAHnKJaLcnMZYh7\"], \"audience_id\": \"aud_4KOlh9t2uw5od4qypqCtyrZyDq2\"}"))
  .build();
HttpResponse<String> response = client.send(request,
  HttpResponse.BodyHandlers.ofString());

using System.Net.Http.Headers;
using System.Text;

var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "your_api_key");

var content = new StringContent(@"{""action"": ""add_to_audience"", ""ids"": [""con_4K9kQdrXth7am0TPKvPrR5yd2oo"", ""con_4KiXIs4xLTcJIAHnKJaLcnMZYh7""], ""audience_id"": ""aud_4KOlh9t2uw5od4qypqCtyrZyDq2""}", Encoding.UTF8, "application/json");
var response = await http.PostAsync("https://api.emailit.com/v2/contacts/bulk", content);

PHP

use Illuminate\Support\Facades\Http;

$result = Http::withToken('your_api_key')
  ->post('https://api.emailit.com/v2/contacts/bulk', ['action' => 'add_to_audience', 'ids' => ['con_4K9kQdrXth7am0TPKvPrR5yd2oo', 'con_4KiXIs4xLTcJIAHnKJaLcnMZYh7'], 'audience_id' => 'aud_4KOlh9t2uw5od4qypqCtyrZyDq2'])
  ->json();

Terminal

curl -X POST https://api.emailit.com/v2/contacts/bulk \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "add_to_audience", "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"], "audience_id": "aud_4KOlh9t2uw5od4qypqCtyrZyDq2"}'

JSON

{
  "object": "contact_bulk",
  "action": "add_to_audience",
  "processed": 2,
  "ids": ["con_4K9kQdrXth7am0TPKvPrR5yd2oo", "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7"]
}

JSON

{
  "error": "A maximum of 100 contacts can be updated per request"
}

JSON

{
  "error": "One or more contacts were not found",
  "missing": ["con_4K3pZc1Q9nWm2LrT8vYb5Hd0XaE"]
}

JSON

{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": {
    "used": 50000,
    "limit": 50000,
    "plan": "pro"
  }
}

Tags zu einem Kontakt hinzufügen

Fügt einem Kontakt Tags hinzu. Tags, die der Kontakt bereits hat, bleiben unverändert. Erfordert einen API-Schlüssel mit dem Scope full.

Tags werden ohne Leerzeichen am Anfang und Ende und in Kleinbuchstaben gespeichert, mehrere Leerzeichen in Folge werden zu einem zusammengefasst, und ein Tag kann bis zu 64 Zeichen lang sein. Wenn mindestens ein Tag neu ist, sendet Emailit das Event contact.updated mit den neuen tags und den alten in previous.tags, das Automatisierungen mit dem Trigger Tag added startet. Siehe Tags und Lead-Score.

POST/contacts/{id}/tags

Pfadparameter

idstringerforderlich

Die ID des Kontakts (con_…) oder seine E-Mail-Adresse, URL-kodiert.

Body-Parameter

tagsstring[]erforderlich

Die hinzuzufügenden Tags, bis zu 50.

Rückgabe

dataobject

id und email des Kontakts, alle seine tags nach der Änderung und changed, die hinzugefügten Tags.

messagestring

Zum Beispiel 1 tag added. oder No tags changed.

Gibt 400 zurück, wenn ein Tag leer oder länger als 64 Zeichen ist, und 404, wenn der Kontakt nicht existiert.

JSON

{
  "data": {
    "id": "con_2kq8Vt4xLm7Rz",
    "email": "ada@example.com",
    "tags": ["customer", "vip", "webinar-2026"],
    "changed": ["customer", "webinar-2026"]
  },
  "message": "2 tags added."
}

POST/contacts/{id}/tags

Terminal

curl -X POST https://api.emailit.com/v2/contacts/ada@example.com/tags \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["customer", "webinar-2026"]}'

JavaScript

const res = await fetch('https://api.emailit.com/v2/contacts/ada@example.com/tags', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"tags": ["customer", "webinar-2026"]}),
});
const result = await res.json();

Python

import os, requests

r = requests.post(
    "https://api.emailit.com/v2/contacts/ada@example.com/tags",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
    json={"tags": ["customer", "webinar-2026"]},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->post('contacts/ada@example.com/tags', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
    'json' => ['tags' => ['customer', 'webinar-2026']],
]);
$result = json_decode($response->getBody(), true);

Tags von einem Kontakt entfernen

Entfernt Tags von einem Kontakt. Tags, die der Kontakt nicht hat, werden ignoriert. Erfordert einen API-Schlüssel mit dem Scope full.

Wenn mindestens ein Tag entfernt wird, sendet Emailit das Event contact.updated mit previous.tags, das Automatisierungen mit dem Trigger Tag removed startet. Siehe Tags und Lead-Score.

DELETE/contacts/{id}/tags

Pfadparameter

idstringerforderlich

Die ID des Kontakts (con_…) oder seine E-Mail-Adresse, URL-kodiert.

Body-Parameter

tagsstring[]erforderlich

Die zu entfernenden Tags, bis zu 50. Der Abgleich erfolgt in Kleinbuchstaben.

Rückgabe

dataobject

id und email des Kontakts, seine verbleibenden tags und changed, die entfernten Tags.

messagestring

Zum Beispiel 1 tag removed. oder No tags changed.

Gibt 404 zurück, wenn der Kontakt nicht existiert.

DELETE/contacts/{id}/tags

Terminal

curl -X DELETE https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/tags \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["trial"]}'

JavaScript

const res = await fetch('https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/tags', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"tags": ["trial"]}),
});
const result = await res.json();

Python

import os, requests

r = requests.delete(
    "https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/tags",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
    json={"tags": ["trial"]},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->delete('contacts/con_2kq8Vt4xLm7Rz/tags', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
    'json' => ['tags' => ['trial']],
]);
$result = json_decode($response->getBody(), true);

Gibt die Tags zurück, die Kontakte im Workspace tragen, alphabetisch sortiert, mit der Anzahl der Kontakte, die das jeweilige Tag haben. Erfordert einen API-Schlüssel mit dem Scope full. Um die Kontakte mit einem Tag aufzulisten, verwenden Sie Kontakte auflisten mit filter[tag].

GET/contacts/tags

Query-Parameter

searchstring

Nur Tags, die diesen Text enthalten.

limitintegerStandardwert: 200

Wie viele Tags zurückgegeben werden, von 1 bis 1000.

Rückgabe

dataobject[]

Jedes Tag als { "object": "tag", "tag": "customer", "contacts": 42 }.

GET/contacts/tags

Terminal

curl "https://api.emailit.com/v2/contacts/tags?search=web" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JavaScript

const res = await fetch('https://api.emailit.com/v2/contacts/tags?search=web', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}` },
});
const result = await res.json();

Python

import os, requests

r = requests.get(
    "https://api.emailit.com/v2/contacts/tags?search=web",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->get('contacts/tags?search=web', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
]);
$result = json_decode($response->getBody(), true);

Lead-Score eines Kontakts ändern

Addiert Punkte zum Lead-Score eines Kontakts, zieht sie ab oder setzt ihn. Erfordert einen API-Schlüssel mit dem Scope full.

Die Änderung ist atomar, sodass parallele Aufrufe sich nicht gegenseitig überschreiben. Der Score beginnt bei 0, kann negativ werden und bleibt innerhalb von ±1.000.000.000. Wenn sich der Score ändert, sendet Emailit das Event contact.updated mit score und previous.score, das Automatisierungen mit dem Trigger Score changed startet. Siehe Tags und Lead-Score.

POST/contacts/{id}/score

Pfadparameter

idstringerforderlich

Die ID des Kontakts (con_…) oder seine E-Mail-Adresse, URL-kodiert.

Body-Parameter

operationstringStandardwert: add

add, subtract oder set.

valueintegererforderlich

Die zu addierenden oder abzuziehenden Punkte oder der neue Score.

Rückgabe

dataobject

id und email des Kontakts, der neue score und der previous_score.

messagestring

Zum Beispiel Score is now 55.

Gibt 400 zurück, wenn operation oder value ungültig ist, und 404, wenn der Kontakt nicht existiert.

JSON

{
  "data": { "id": "con_2kq8Vt4xLm7Rz", "email": "ada@example.com", "score": 55, "previous_score": 45 },
  "message": "Score is now 55."
}

POST/contacts/{id}/score

Terminal

curl -X POST https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/score \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation": "add", "value": 10}'

JavaScript

const res = await fetch('https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/score', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"operation": "add", "value": 10}),
});
const result = await res.json();

Python

import os, requests

r = requests.post(
    "https://api.emailit.com/v2/contacts/con_2kq8Vt4xLm7Rz/score",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
    json={"operation": "add", "value": 10},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->post('contacts/con_2kq8Vt4xLm7Rz/score', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
    'json' => ['operation' => 'add', 'value' => 10],
]);
$result = json_decode($response->getBody(), true);

Kontakte exportieren

Lädt passende Kontakte als CSV- oder XLSX-Datei herunter.

GET/contacts/export

Erfordert einen API-Schlüssel mit dem Scope full. Akzeptiert dieselben Such-, Filter- und Sortierparameter wie Kontakte auflisten, übergeben im Query-String, ohne Paginierung. POST /contacts/export funktioniert genauso. Ein Export kann bis zu 10.000 Kontakte enthalten; passen mehr, gibt die Anfrage 422 zurück. Grenzen Sie dann die Filter weiter ein.

Query-Parameter

formatstringStandardwert: csv

csv oder xlsx.

search, audience_id, unsubscribed, sort, order, match, key.conditionstring

Dieselben Parameter wie bei Kontakte auflisten.

Rückgabe

Gibt die Datei als Anhang zurück: contacts.csv (text/csv; charset=utf-8) oder contacts.xlsx. Jede Zeile ist ein Kontakt mit diesen Spalten:

Spalte	Inhalt
`email`	Die E-Mail-Adresse.
`first_name`, `last_name`	Vor- und Nachname.
`unsubscribed`	`true` oder `false`.
`audiences`	Die Namen der Kontaktlisten des Kontakts, getrennt durch `;` .
`tags`	Die Tags des Kontakts, getrennt durch `;` .
`score`	Der Lead-Score.
Eine Spalte pro eigenem Feld	Der Wert jedes im Workspace definierten eigenen Felds, benannt nach seinem Schlüssel. Listen werden mit `;` verbunden.
`created_at`, `updated_at`	Zeitstempel im Format ISO 8601.

GET/contacts/export

JavaScript

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', {
  headers: { Authorization: 'Bearer your_api_key' },
});
await writeFile('contacts.csv', Buffer.from(await response.arrayBuffer()));

Python

import requests

response = requests.get(
  "https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  headers={"Authorization": "Bearer your_api_key"}
)
with open("contacts.csv", "wb") as f:
    f.write(response.content)

PHP

$ch = curl_init('https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer your_api_key',
  ],
]);
file_put_contents('contacts.csv', curl_exec($ch));
curl_close($ch);

Ruby

require "net/http"

uri = URI("https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer your_api_key"
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
File.binwrite("contacts.csv", http.request(req).body)

req, _ := http.NewRequest("GET", "https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", nil)
req.Header.Set("Authorization", "Bearer your_api_key")

resp, err := http.DefaultClient.Do(req)
if err != nil {
  return err
}
defer resp.Body.Close()

out, _ := os.Create("contacts.csv")
defer out.Close()
io.Copy(out, resp.Body)

Rust

let bytes = reqwest::Client::new()
    .get("https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2")
    .bearer_auth("your_api_key")
    .send()
    .await?
    .bytes()
    .await?;
std::fs::write("contacts.csv", &bytes)?;

Java

import java.net.http.*;
import java.net.URI;
import java.nio.file.Path;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2"))
  .header("Authorization", "Bearer your_api_key")
  .GET()
  .build();
client.send(request, HttpResponse.BodyHandlers.ofFile(Path.of("contacts.csv")));

using System.Net.Http.Headers;

var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "your_api_key");

var bytes = await http.GetByteArrayAsync("https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2");
await File.WriteAllBytesAsync("contacts.csv", bytes);

PHP

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;

$csv = Http::withToken('your_api_key')
  ->get('https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2')
  ->body();
Storage::put('contacts.csv', $csv);

Terminal

curl "https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2" \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o contacts.csv

Text

email,first_name,last_name,unsubscribed,audiences,company,plan,created_at,updated_at
ada@example.com,Ada,Lovelace,false,Newsletter,Analytical Engines,pro,2026-10-01T10:20:31.000000Z,2026-10-01T10:20:31.000000Z

JSON

{
  "error": "format must be csv or xlsx"
}

JSON

{
  "error": "Export is limited to 10000 contacts. Narrow your filters and try again."
}

Kontakt löschen

Löscht einen Kontakt mit all seinen Mitgliedschaften in Kontaktlisten endgültig.

DELETE/contacts/{id}

Erfordert einen API-Schlüssel mit dem Scope full. Das Löschen lässt sich nicht rückgängig machen. Wenn Sie jemandem keine E-Mails mehr senden, den Datensatz aber behalten möchten, aktualisieren Sie den Kontakt mit unsubscribed: true oder setzen Sie die Adresse auf Ihre Sperrliste. Löst für jede Mitgliedschaft subscriber.deleted aus, danach contact.deleted.

Pfadparameter

idstringerforderlich

Die ID des Kontakts (con_…) oder seine E-Mail-Adresse, URL-kodiert.

Rückgabe

objectstring

Immer contact.

idstring

Die ID des gelöschten Kontakts.

emailstring

Die E-Mail-Adresse des Kontakts.

deletedboolean

Immer true.

DELETE/contacts/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

await emailit.contacts.delete('con_4Kt4ZXloQR8WGcMsYx8PFCUjokM');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

client.contacts.delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM")

PHP

$emailit = Emailit::client('your_api_key');

$emailit->contacts()->delete('con_4Kt4ZXloQR8WGcMsYx8PFCUjokM');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

client.contacts.delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

err := client.Contacts.Delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

emailit.contacts.delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM").await?;

Java

import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

emailit.contacts().delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM");

using Emailit;

var emailit = new EmailitClient("your_api_key");

emailit.Contacts.Delete("con_4Kt4ZXloQR8WGcMsYx8PFCUjokM");

PHP

use Emailit\Laravel\Facades\Emailit;

Emailit::contacts()->delete('con_4Kt4ZXloQR8WGcMsYx8PFCUjokM');

Terminal

curl -X DELETE https://api.emailit.com/v2/contacts/con_4Kt4ZXloQR8WGcMsYx8PFCUjokM \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "contact",
  "id": "con_4Kt4ZXloQR8WGcMsYx8PFCUjokM",
  "email": "alan@example.com",
  "deleted": true
}

JSON

{
  "error": "Contact not found"
}

Kontakt erstellen

Body-Parameter

Rückgabe

Kontakt abrufen

Pfadparameter

Rückgabe

Kontakt aktualisieren

Pfadparameter

Body-Parameter

Rückgabe

Kontakte auflisten

Query-Parameter

Filter

Rückgabe

Kontakte gesammelt aktualisieren

Body-Parameter

Rückgabe

Tags zu einem Kontakt hinzufügen

Pfadparameter

Body-Parameter

Rückgabe

Tags von einem Kontakt entfernen

Pfadparameter

Body-Parameter

Rückgabe

Tags auflisten

Query-Parameter

Rückgabe

Lead-Score eines Kontakts ändern

Pfadparameter

Body-Parameter

Rückgabe

Kontakte exportieren

Query-Parameter

Rückgabe

Kontakt löschen

Pfadparameter

Rückgabe