Tworzenie kontaktu
Zapisuje jeden adres w książce adresowej przestrzeni roboczej. To adres jest tożsamością, więc nie ma id do wybrania ani id w odpowiedzi. Przed zapisem adres jest przycinany i zamieniany na małe litery, a kontakt zapisuje się z `source` ustawionym na `manual`. Nowy kontakt w chwili zapisu trafia do wbudowanej domyślnej grupy odbiorców, a także do wszystkich wskazanych w `audienceIds`.
Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.
POST /contacts
Zapisuje jeden adres w książce adresowej przestrzeni roboczej. To adres jest tożsamością, więc nie ma id do wybrania ani id w odpowiedzi. Przed zapisem adres jest przycinany i zamieniany na małe litery, a kontakt zapisuje się z source ustawionym na manual. Nowy kontakt w chwili zapisu trafia do wbudowanej domyślnej grupy odbiorców, a także do wszystkich wskazanych w audienceIds.
Przykład
Wymaga contacts:write. Wysłanie audienceIds wymaga dodatkowo audiences:write.
curl -X POST "$OE/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]", "name": "Grace Hopper", "notes": "Met at the compiler workshop"}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": "Met at the compiler workshop", "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-18T09:00:00.000Z", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" } ]}Adres, który już jest w książce adresowej, daje 409 contact_exists, a nie scalenie, więc ponowienie nie nadpisze po cichu nazwy, którą ktoś zmienił w aplikacji. Zamiast tego odczytaj wiersz i wyślij PATCH.
lastSeenAt pozostaje null, dopóki na ten adres nie pójdzie poczta z edytora wiadomości w aplikacji. source i lastSeenAt należą do serwera i nie są przyjmowane w treści żądania.
Id grupy odbiorców w audienceIds, które nie istnieje w tej przestrzeni roboczej, daje 404 i nic nie zostaje zapisane.