Foyer API
API by Foyer · rest
Foyer is an AI phone call screener. A member forwards their phone line to Foyer; Foyer answers callers it does not know, asks who they are and why they are calling, and then rings the member, holds the call for review, takes a voicemail, or turns the caller away. Saved contacts ring straight through. This API lets a member connect their own AI assistant or scripts to their own Foyer account. Everything it returns belongs to the member who made the key; there is no way to reach another member's data. Authentication Send a personal API key in the Authorization header: Authorization: Bearer fyr_…. The member makes keys in the Foyer app or dashboard under Settings › Connected apps. A key is shown once, expires after 90 days (or sooner if chosen), and can be revoked at any time. Keys are never accepted in the URL. Permissions (scopes) Each key carries the scopes the member ticked when making it: | Scope | What it allows | |---|---| | calls:read | See calls, summaries,…
Endpoint: https://api.hifoyer.com/
Verification: observed. Source: crawl.
Capabilities (78)
- The member's name plan and Foyer number
- Change the member's name
- How Foyer refers to the member
- Saved personal greetings
- Save a personal greeting
- Remove a saved personal greeting
- Play a recording from a link
- List screened calls
- One call in full
- Archive a call
- A five-minute link to a recording
- Mark a call read
- Mark a call unread
- Tell Foyer how this caller should be handled
- Report the caller as spam
- Unarchive a call
- Mark a voicemail heard
- Contacts and how Foyer treats them
- Add a contact
- Screen a contact like a stranger for a while
- Let a caller ring straight through
- Remove a contact (archive)
- Change one contact's preferences
- Restore an archived contact
- Screen a caller again