Pāriet uz dokumentāciju
API

Izveidot kontaktu

Saglabā vienu adresi darbvietas adrešu grāmatā. Adrese ir identitāte, tāpēc nav id, ko izvēlēties, un tā nav arī atbildē. Pirms saglabāšanas tā tiek apcirsta no atstarpēm un pārveidota mazajiem burtiem, un kontakts tiek saglabāts ar `source` vērtību `manual`. Jaunais kontakts rakstīšanas brīdī pievienojas iebūvētajai noklusējuma auditorijai, kā arī visam, kas nosaukts `audienceIds`.

POSTapi.openemail.uk/contacts

Izpilda īstu izsaukumu pret jūsu darbvietu, ar jūsu paša atslēgu.

POST /contacts

Saglabā vienu adresi darbvietas adrešu grāmatā. Adrese ir identitāte, tāpēc nav id, ko izvēlēties, un tā nav arī atbildē. Pirms saglabāšanas tā tiek apcirsta no atstarpēm un pārveidota mazajiem burtiem, un kontakts tiek saglabāts ar source vērtību manual. Jaunais kontakts rakstīšanas brīdī pievienojas iebūvētajai noklusējuma auditorijai, kā arī visam, kas nosaukts audienceIds.

Piemērs

Nepieciešams contacts:write. audienceIds sūtīšanai nepieciešams arī audiences:write.

curl
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"}'
Atbilde
{  "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" }  ]}

Adrese, kas jau ir grāmatā, ir 409 contact_exists, nevis sapludināšana, tāpēc atkārtojums nevar klusi pārrakstīt vārdu, ko kāds rediģējis lietotnē. Nolasiet rindu un labojiet to ar PATCH.

lastSeenAt paliek null, līdz uz adresi aiziet pasts no lietotnes sastādītāja. source un lastSeenAt pieder serverim un pieprasījuma ķermenī netiek pieņemti.

Auditorijas id laukā audienceIds, kas šajā darbvietā neeksistē, ir 404, un nekas netiek ierakstīts.