Skip to content

DM-Ready Audience

Read by connected AIs with get_playbook and id dm-ready-audience.

Find reachable contacts with a clear reason to hear from you.

Use for finding which contacts they can appropriately DM. Not for writing a DM.

The user might say: “Find contacts who are appropriate for a direct message and explain the relationship or consent basis for each.”

  1. Their contacts and lists. Call get_contacts with {"limit":50}.
  2. Who can be messaged. Call dm.preview_recipients (through run_write_action) with {"type":"CONTACT_LIST","listId":"<contact"}.
  3. Explain the relationship or consent basis for each. Don’t write or send DMs here.