API

Caktoni audiencat e një kontakti

Thotë saktësisht në cilat audienca është një kontakt, me një thirrje. Kontakti hyn në çdo audiencë te `audienceIds` ku ende nuk është dhe del nga çdo tjetër. Audienca e parazgjedhur ruhet gjithmonë, prandaj një listë bosh e lë kontaktin vetëm në audiencën e parazgjedhur.

PUTapi.openemail.uk/contacts/{email}/audiences

Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.

PUT /contacts/{email}/audiences

Thotë saktësisht në cilat audienca është një kontakt, me një thirrje. Kontakti hyn në çdo audiencë te audienceIds ku ende nuk është dhe del nga çdo tjetër. Audienca e parazgjedhur ruhet gjithmonë, prandaj një listë bosh e lë kontaktin vetëm në audiencën e parazgjedhur.

Shembull

Kërkon audiences:write, sepse shkruan anëtarësime dhe jo kontaktin. Kodoni @ në URL. audienceIds mban deri në 100 id.

curl

curl -X PUT "$OE/contacts/grace%40example.com/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{  "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"]}'

Përgjigje

{  "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",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" },    { "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "builtin": null }  ]}

Kontakti duhet të ekzistojë tashmë. Një adresë që nuk është në libër jep 404 contact_not_found. Krijojeni me POST /contacts, që pranon edhe audienceIds.

Një id që nuk emërton asnjë audiencë në këtë hapësirë pune jep 404 audience_not_found dhe asgjë nuk ndryshon, prandaj një gabim shkrimi nuk mund ta heqë dikë në heshtje nga një listë. Dërgimi sërish i së njëjtës thirrje nuk ndryshon asgjë.

Përgjigjja është kontakti ashtu siç e kthen GET /contacts/{email}, me çdo audiencë ku ndodhet pas ndryshimit.