Faxette

Use this only after the person confirms they want to block a number: future faxes from it to the organization are deleted as they arrive, and nobody is emailed. Pass inbound_fax_id to block the number a received fax came from, or number for a number the person gives you. Faxes already in the inbox stay. unblock_sender undoes it. Needs the person to sign in to Faxette.

Use this to add a file the person gave you to a fax: a PDF, or a photo saved as JPG, PNG, WEBP or HEIC, up to 20 MB. Call it once per file, before create_fax, in the order the files should be faxed. It returns document_id, upload_url and upload_headers: PUT the file's exact bytes to upload_url with those headers within 5 minutes, then pass document_id to create_fax within an hour. Nothing is faxed or charged. If you can't read the file's bytes, don't use this: call create_fax without document_ids, and the person adds the file on the status page.

Use this once the person has confirmed the fax number, and given you their email if they aren't signed in. It creates the fax and returns status_url, the page where the person checks the fax number, documents and price, and pays to send it. Nothing is sent or charged until they pay there. Pass the document_ids from create_document. Without them, the fax waits on the status page for the person to add their files. Choose a private random idempotency_key for each intentional new fax. Reuse the exact same key and request after a timeout or request_in_progress; never change the key just to retry. The key is retained for 24 hours. To check a fax, use get_fax_status or get_fax.

Use this to see which Faxette account the person signed in with: their name, email, credit, and whether it's the US or EU copy. Needs the person to sign in to Faxette; calling it while they aren't asks the app to sign them in. It changes nothing.

Use this to see which fax numbers an organization has blocked. Faxes from them are deleted as they arrive. Returns 25 at a time, newest first. Pass next_page back as page for more. Needs the person to sign in to Faxette. It changes nothing.

Use this before preparing a fax to check supported countries, languages, file limits and current retail and credit pricing rules. Signed in, it lists the account's service. Without signing in, it lists both, the US service first and then the European one, each with its own countries and currency. Prices are before tax; the exact total is confirmed after document processing and at checkout. It changes nothing.

Use this for one fax from the person's Faxette account: its status, price, payment, documents' file names and history. Pass the id from get_faxes or create_fax. While a fax is sending, call it at most once a minute. Needs the person to sign in to Faxette; calling it while they aren't asks the app to sign them in. It changes nothing.

Use this when the person asks for a delivery report or the transmitted document. Returns the destination, page count, delivery result, timestamps and attempts. A report URL is available after delivery, failure or cancellation. Document links are only returned for the signed-in owner of an account fax while its files are retained. Report and document links expire after five minutes. A delivered fax does not establish that the recipient read it. It changes nothing.

No description returned.

Use this when the person asks how their fax is doing, or to see whether it's ready to pay. It reads the fax from its status_url and returns its status, page count, price, payment and attempts. checkout_available is true once the person can pay on the status page. It changes nothing. While a fax is sending, call it at most once a minute.

Use this when the person asks about faxes they've sent from their Faxette account, like what they sent last week or which faxes failed. Returns 25 at a time, newest first. Pass next_page back as page for the next 25. Filter with status, for example ["failed"] or ["delivered"]. Use get_fax for one fax's details. Needs the person to sign in to Faxette; calling it while they aren't asks the app to sign them in. It changes nothing.

Use this for one received fax: who sent it, when, how many pages, and pdf_url, a link to its PDF for 5 minutes, for apps that can download files. Getting the link marks the fax read for the person. To read what the fax says in the chat, use read_inbound_fax instead. Needs the person to sign in to Faxette.

Use this when the person asks about faxes their organization received, like whether a pharmacy faxed back or what came in today. Returns 25 at a time, newest first, with who sent each, which number it came to and whether the person has read it. Pass unread to see only unread ones, and next_page back as page for more. It doesn't open or mark anything. Needs the person to sign in to Faxette.

Use this to see which organizations the person let this app use: each one's id, name, role, plan, card on file and fax numbers. Pass an id as organization to the inbox tools, create_fax and get_faxes. An empty list means the person selected none when connecting; they can reconnect the app to choose. Needs the person to sign in to Faxette. It changes nothing.

Search Faxette's catalog by agency, form number or purpose. Returns only numbers supported by this connector, with the official source and verification date. An empty result means we have no current match, not that the office has no fax number. Show the source and have the person confirm the right office before creating a fax. It changes nothing.

Open the private upload and PDF review interface for an account fax before approving payment. Requires sign-in. The browser review link works when the client cannot show MCP Apps.

No description returned.

Use this only when the person asks what a received fax says, or to summarize it. Returns its pages as images, up to 10. It marks the fax read for the person. Don't repeat medical or legal contents beyond what the person needs. Needs the person to sign in to Faxette.

Use this only after the person asks to resend a failed fax and confirms its destination, including any corrected number. Check get_fax or get_fax_status first. Reuses the existing fax, payment hold and resend rules; it does not create a new paid fax. Faxette refuses expired resend windows and exhausted retries. If a call is interrupted, check the existing fax before calling again.

Use this to send a fax from the person's Faxette credit, or an organization's fax on its plan or card. For an organization's fax, pass the payment_method from get_fax's payment_option once the person agrees to it, and for saved_card its quote; amount_cents isn't needed. Only for a fax in their account that's ready to pay for: call get_fax first. Show the prepared PDF with open_fax_review or its review_url. Have the person confirm the destination, documents and credit_price, explain that it comes from their credit, and call this only once they clearly agree. If get_account shows their credit doesn't cover it, give them the status page instead, where they can pay for this fax by card. For the EU connector, also explain that sending starts immediately and the person's right to cancel ends once the fax is delivered. Obtain their explicit agreement before setting immediate_sending_consent to true. Needs the person to sign in to Faxette; calling it while they aren't asks the app to sign them in.

Use this when the person wants faxes from a blocked number to reach the organization again. Members are emailed when they arrive. Needs the person to sign in to Faxette.

No description returned.