How it works

With your instance deployed, redirect users to:

https://YOUR_HANDSHAKE_INSTANCE_URL/auth/HANDLER_ID/redirect

Where HANDLER_ID is either monday or the value passed to the optional id argument of the Monday() factory. (See Options below.)

Handshake will take each user through the Monday OAuth flow and before sending them back to you, at the URL specified by the callback_uri query parameter.

Options

Modify your app/options.ts file to include the Monday() handler like so:

import { HandshakeOptions, Monday } from "handshake";
 
const options: HandshakeOptions = {
  handles: [
    Monday({
      clientId: process.env.MONDAY_CLIENT_ID!, // string
      clientSecret: process.env.MONDAY_CLIENT_SECRET!, // string
      scopes: ["account:read"], // MondayScope[]
    }),
  ],
  // ...
};

Consult the reference to learn about HandshakeOptions.

Provider setup

monday-credentials

monday-credentials

Troubleshooting

"invalid_scope: Invalid scope param"

You configured Handshake to request a scope that you didn't enable in your app's settings.

Facing an issue not included here? Open an issue on GitHub to get help.