Prerequisites

• Create a Marq account
• Create your app in Marq

Create the authorization request link

Authorization request link

Direct the user to the appropriate authorization url in a browser with the following URL query parameters appended in order to grant access:

https://app.marq.com/oauth2/authorizeAccount?response_type=code&client_id={required_client_id_value}&scope={required_scopes}&redirect_uri={required_redirect_uri_value}&state={optional_state_value}

📘

Account vs User Token URLs

As a reminder, there are two different Access tokens that can be used with Marq REST APIS:

1. Account (https://app.marq.com/oauth2/authorizeAccount)
2. User (https://app.marq.com/oauth2/authorize)

To ensure your app obtains the correct token type, you will need to utilize the correct authorization URL

Authorization request link with line breaks

(We've added line breaks for better readability. Delete the line breaks for actual use.)

https://app.marq.com/oauth2/authorizeAccount?response_type=code
&client_id={required_client_id_value}
&scope={required_scopes}
&redirect_uri={required_redirect_uri_value}
&state={optional_state_value}

📘

Encoded URLs

Make sure to encode the URL as part of your parameter to resolve correctly.

e.g.

https://app.marq.com/oauth2/authorizeAccount?...&redirect_uri=https://users.app.marq.com/oauth2/clients/fCWlNdTt-rRw6k9W0SETKRZkN3bqGRv5vUtV2oH7/redirect

should be updated to when sending a user to the authorization flow

https://app.marq.com/oauth2/authorizeAccount?response_type=code&client_id=fCWlNdTt-rRw6k9W0SE...&redirect_uri=https%3A%2F%2Fusers.app.marq.com%2Foauth2%2Fclients%2FfCWlNdTt-rRw6k9W0SETKRZkN3bqGRv5vUtV2oH7%2Fredirect

Authorization URL Query Parameters