API

Dodawanie kontaktu do grupy odbiorców

Przyjmuje adres znajdujący się już w książce adresowej przestrzeni roboczej i zwraca przynależność wraz z kontaktem, na który ona wskazuje. Na parę grupy odbiorców i kontaktu przypada jedna przynależność, więc dodanie kogoś, kto już jest w grupie odbiorców, odpowiada `200` z pierwotnym `addedAt`, zamiast tworzyć drugą przynależność albo kończyć się błędem. Dzięki temu wywołanie można bezpiecznie ponowić.

POSTapi.openemail.uk/audiences/{id}/contacts

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

POST /audiences/{id}/contacts

Przyjmuje adres znajdujący się już w książce adresowej przestrzeni roboczej i zwraca przynależność wraz z kontaktem, na który ona wskazuje. Na parę grupy odbiorców i kontaktu przypada jedna przynależność, więc dodanie kogoś, kto już jest w grupie odbiorców, odpowiada 200 z pierwotnym addedAt, zamiast tworzyć drugą przynależność albo kończyć się błędem. Dzięki temu wywołanie można bezpiecznie ponowić.

Przykład

Wymaga audiences:write.

curl

curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{  "email": "[email protected]"}'

Odpowiedź

{  "object": "audience_member",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "addedAt": "2026-09-18T09:30:00.000Z",  "contact": {    "object": "contact",    "email": "[email protected]",    "name": "Grace Hopper",    "source": "manual",    "notes": null,    "lastSeenAt": null,    "createdAt": "2026-09-18T09:00:00.000Z",    "updatedAt": "2026-09-18T09:00:00.000Z"  }}

Adres, który nie jest kontaktem, zostaje odrzucony z 422 contact_not_found, zamiast zostać od razu utworzony. Zapisz go najpierw przez POST /contacts.

audiences:write to jedyne sprawdzane uprawnienie. Umieszczenie kontaktu na liście nie jest zapisem do samego kontaktu.

Jedno wywołanie na kontakt. W tej wersji nie ma dodawania zbiorczego, a późniejsze usunięcie kontaktu kasuje razem z nim tę przynależność.