Fax From monday.com — Using an Automation Webhook and Our API

How it works

You build a monday automation like When status changes to Ready to fax, send a webhook and point it at a relay you host. monday posts the item's column values — a fax-number column and a document link — to that relay, which adds your Authorization header and reshapes the payload into a /v1/faxes request. If you prefer no relay, a monday app built on the apps framework can run server-side code that calls our API directly with the key kept in the app's secrets. The fax id from the response is written back to the item with monday's GraphQL API, and a registered fax webhook can flip a status column when delivery is confirmed.

What you can do

• ✓Fax a monday item when a status column changes via an automation webhook
• ✓Use a thin relay to add the bearer key monday's native webhook can't set
• ✓Or run a monday app's server code that POSTs to /v1/faxes directly
• ✓Read the fax-number and document-link columns into the request
• ✓Write the returned fax id back to the item with monday's GraphQL API
• ✓Flip a status column from a registered fax.delivered webhook

Setup steps

1. 1Put the account on Business or Enterprise and create a key at /dashboard/developers
2. 2Add columns for the fax number, a document link, a trigger status, and a result
3. 3Create a monday automation that posts a webhook when the status flips
4. 4Point it at a relay (or a monday app) that adds your key and calls /v1/faxes
5. 5Write the returned fax id back to the item via monday's GraphQL API
6. 6Register a fax webhook to update the status column on delivery

Example

// Relay behind a monday automation webhook (Node)
app.post("/monday-fax", async (req, res) => {
  const { faxNumber, docUrl } = req.body.event.columnValues;
  await fetch("https://www.sendfaxmail.com/v1/faxes", {
    method: "POST",
    headers: { Authorization: "Bearer sfm_live_xxxxxxxx",
               "Content-Type": "application/json" },
    body: JSON.stringify({ to: faxNumber, document_url: docUrl }),
  });
  res.sendStatus(200);
});

monday.com Fax — FAQ