Personen auflisten
Alle, die die Kontaktseite der App listet: die gespeicherten Kontakte und jede Adresse, die in Mails als Absender oder Empfänger der neuesten Nachricht eines Threads vorkommt, mit der Zahl der Threads, die sie mit dem Postfach teilt, und dem Zeitpunkt der letzten Mail. Eine Person, die in Mails vorkommt und gespeichert ist, ist eine Zeile. Das Paging ist Keyset-basiert: `limit` reicht bis 100 und ist standardmäßig 25, und `nextCursor` geht als `cursor` zurück, solange `hasMore` true ist.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
GET /contacts/people
Alle, die die Kontaktseite der App listet: die gespeicherten Kontakte und jede Adresse, die in Mails als Absender oder Empfänger der neuesten Nachricht eines Threads vorkommt, mit der Zahl der Threads, die sie mit dem Postfach teilt, und dem Zeitpunkt der letzten Mail. Eine Person, die in Mails vorkommt und gespeichert ist, ist eine Zeile. Das Paging ist Keyset-basiert: limit reicht bis 100 und ist standardmäßig 25, und nextCursor geht als cursor zurück, solange hasMore true ist.
Beispiel
Erfordert contacts:read. Die Adressen aus den Mails sind nur enthalten, wenn der Schlüssel auch threads:read hat.
curl "$OE/contacts/people?sort=threads&limit=25" -H "$AUTH"{ "object": "list", "data": [ { "object": "person", "email": "[email protected]", "displayEmail": "[email protected]", "name": "Ada Lovelace", "saved": true, "source": "manual", "notes": "Met at the engine demo", "photoUrl": null, "threads": 42, "lastAt": "2026-09-22T16:04:11.000Z", "createdAt": "2026-08-01T10:00:00.000Z", "updatedAt": "2026-09-01T09:12:00.000Z", "blockedBy": null }, { "object": "person", "email": "[email protected]", "displayEmail": "[email protected]", "name": "Shop", "saved": false, "source": null, "notes": null, "photoUrl": null, "threads": 17, "lastAt": "2026-09-21T07:30:00.000Z", "createdAt": null, "updatedAt": null, "blockedBy": { "rule": "shop.example", "list": "blockedDomains" } } ], "hasMore": true, "nextCursor": "WyIyMDI2LTA5LTIxVDA3OjMwOjAwLjAwMFoiLDE3XQ", "seen": true}sort ist recent (der Standard), neueste Mail zuerst und gespeicherte Kontakte ohne Mail dahinter, name, nach Name oder sonst nach Adresse und ohne Groß- und Kleinschreibung, oder threads, die meisten Threads zuerst. Bei Gleichstand entscheidet die Adresse, sodass ein Durchlauf nie eine Zeile wiederholt oder überspringt.
q durchsucht Namen, Adressen und Notizen. email liest eine einzelne Adresse, so holst du die Zahl der Threads und die letzte Mail einer Person. blocked=true liefert nur die Personen, die die Blockliste des Workspace blockiert, Regeln für ganze Domains eingeschlossen, und blockedBy nennt die Regel in jeder Zeile.
Ohne threads:read sind die Zeilen nur die gespeicherten Kontakte und seen ist false, weil der Rest aus den Mails gelesen wird. Gelöschte Adressen und die eigenen Adressen des Postfachs werden nie gelistet. Der Cursor ist undurchsichtig: Gib ihn mit denselben sort, q und blocked zurück; einer, der nicht ausgegeben wurde, ist ein 400 invalid_cursor.