{ "opencollection": "1.0.0", "info": { "name": "API Reference agent-webhooks contacts API", "version": "1.0.0" }, "items": [ { "info": { "name": "contacts", "type": "folder" }, "items": [ { "info": { "name": "List Contacts", "type": "http" }, "http": { "method": "GET", "url": "https://api.agentphone.ai/v1/contacts", "headers": [ { "name": "Authorization", "value": "" }, { "name": "X-Sub-Account-Id", "value": "" } ], "params": [ { "name": "limit", "value": "", "type": "query" }, { "name": "offset", "value": "", "type": "query" } ] }, "docs": "List all contacts for this account.\n\nOptional `search` query filters by name or phone number (case-insensitive contains)." }, { "info": { "name": "Create Contact", "type": "http" }, "http": { "method": "POST", "url": "https://api.agentphone.ai/v1/contacts", "headers": [ { "name": "Authorization", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Create a new contact.\n\nPhone number is normalized to E.164 format. Returns 409 if a contact\nwith this phone number already exists for the project." }, { "info": { "name": "Get Contact Capabilities", "type": "http" }, "http": { "method": "GET", "url": "https://api.agentphone.ai/v1/contacts/capabilities", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "phone_number", "value": "", "type": "query", "description": "Phone number to check (E.164 preferred; URL-encode + as %2B)" } ] }, "docs": "Check which messaging channels a phone number supports, without sending\na message.\n\nRuns a live check (typically 1-2 seconds), so the result reflects the\nnumber right now. Capabilities can still change by the time you send.\nRequires at least one active iMessage-capable number on the account." }, { "info": { "name": "Get Contact", "type": "http" }, "http": { "method": "GET", "url": "https://api.agentphone.ai/v1/contacts/:contact_id", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "contact_id", "value": "", "type": "path" } ] }, "docs": "Get a single contact by ID." }, { "info": { "name": "Update Contact", "type": "http" }, "http": { "method": "PATCH", "url": "https://api.agentphone.ai/v1/contacts/:contact_id", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "contact_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update a contact's fields.\n\nIf phoneNumber is updated, it's re-normalized and checked for uniqueness (409 on conflict)." }, { "info": { "name": "Delete Contact", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.agentphone.ai/v1/contacts/:contact_id", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "contact_id", "value": "", "type": "path" } ] }, "docs": "Delete a contact." } ] } ], "bundled": true }