Vytvoření kontaktu
Uloží jednu adresu do adresáře workspace. Identitou je samotná adresa, takže není co volit za id a v odpovědi žádné není. Před uložením se ořízne a převede na malá písmena a kontakt se uloží se `source` nastaveným na `manual`. Nový kontakt při zápisu vstupuje do vestavěného výchozího publika a navíc do všech publik uvedených v `audienceIds`.
Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.
POST /contacts
Uloží jednu adresu do adresáře workspace. Identitou je samotná adresa, takže není co volit za id a v odpovědi žádné není. Před uložením se ořízne a převede na malá písmena a kontakt se uloží se source nastaveným na manual. Nový kontakt při zápisu vstupuje do vestavěného výchozího publika a navíc do všech publik uvedených v audienceIds.
Příklad
Vyžaduje contacts:write. Odeslání audienceIds navíc vyžaduje 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" } ]}Adresa, která už v adresáři je, vrátí 409 contact_exists místo sloučení, takže opakované volání nemůže potichu přepsat jméno, které někdo upravil v aplikaci. Místo toho si řádek načtěte a použijte PATCH.
lastSeenAt zůstává null, dokud na adresu neodejde pošta z editoru zpráv v aplikaci. source a lastSeenAt patří serveru a v těle požadavku se nepřijímají.
Id publika v audienceIds, které v tomto workspace neexistuje, vrátí 404 a nezapíše se nic.