--- title: OAuth 2 description: In order to use any of the Marq APIs, an app must have permission from the user to access their data. This permission can be granted with an OAuth access token following the OAuth 2.0 specification --- [Skip to content](https://help.marq.com/oauth-2#main-content) English Show submenu for translations ![marq.svg\]](https://help.marq.com/hubfs/Brand%20Logos/marq.svg) Open main navigation Close main navigation - English Show submenu for translations - - [Projects](https://app.marq.com/documents#/documents) [Projects](https://app.marq.com/documents#/documents) How can we help? - There are no suggestions because the search field is empty. 1. [Help Center](https://help.marq.com/?hsLang=en) 2. [Integrations](https://help.marq.com/integrations?hsLang=en) 3. [Security and sign-on integrations](https://help.marq.com/integrations?hsLang=en#security-and-sign-on-integrations) # OAuth 2 ## In order to use any of the Marq APIs, an app must have permission from the user to access their data. This permission can be granted with an OAuth access token following the OAuth 2.0 specification #### OAuth 2.0 Limitations When accessing Marq APIs using OAuth 2.0, the following limitations apply: - You must be a team admin in your Marq account in order to obtain the client ID and secret as described below. - Only users in your account can use the app with your client ID and secret. If you would like to develop an app that all Marq users can use, please contact us. - Authorization must happen in the browser, because a user must give consent for the client to access their information. For this reason, the authorization request cannot be made from Postman, curl, or some other HTTP client**.** #### OAuth 2.0 Authorization In order to use any of the Marq APIs, an app must have permission from the user to access their data. This permission can be granted with an OAuth access token following the OAuth 2.0 specification. Details of the OAuth 2.0 authorization process can be found at [https://oauth.net/2/](https://oauth.net/2/). ### App registration To set up your app to use OAuth 2.0, you will need to perform the following steps: - Obtain an OAuth 2.0 **client ID** and **client secret** from [this page](https://app.marq.com/teams?adminSection=apps%2FapiKeys%23custom-oauth2). - Register at least one **redirect URI** on that page. Marq will redirect the user to this location once they have granted access. This should be a URL that you control. Marq will append the authorization code to the URL in the \`code\` query parameter. **Note**: As a service, Marq provides a redirect uri for you to use that allows the user to copy the authorization code to the clipboard. To use it, register the redirect URI \`https://app.Marq.com/oauth2/clients/\/redirect\`. When you use this redirect URI and a user grants access to your app, Marq will redirect the user to a page on our site where they can view and copy the authorization code. ### Authorization (obtaining an access token) When a user wants to allow your app to connect to their Marq account, use the following flow: 1. Direct the user to open  https://app.Marq.com/oauth2/authorize in a browser with the following URL query parameters appended:  | client\_id | The **client ID** you obtained during App registration | | --- | --- | | redirect\_uri | One of the **redirect URIs** you registered for your app during App registration | | scope | The scopes your app is requesting access to, and currently the only scope is \`data-service.admin\` | ``` Example: https://app.Marq.com/oauth2/authorize?client_id=rd0q2geEEHcDvZNpYmYAXBH5eCHYD8x0sCwVyncf&redirect_uri=https://app.Marq.com/oauth2/clients/rd0q2geEEHcDvZNpYmYAXBH5eCHYD8x0sCwVyncf/redirect&scope=data-service.admin ``` 2. In the browser, Marq prompts the user to log in and then asks them to grant access to your app. 3. Once the user grants access, they will be redirected to the URI you specified. The \`code\` query parameter will contain a short-lived **authorization code** that you will use to obtain an access token. 4. Make a POST request to ``` https://users.app.Marq.com/oauth2/token ``` with the following parameters in a JSON object in the body: ``` { "code": "", "client_id": "", "client_secret": "", "grant_type": "authorization_code" } ``` 5. The response will have a JSON object body. It will contain ``` access_token ``` ``` refresh_token ``` ``` expiresproperties ``` which hold the access token, the refresh token, and the expiration time (in milliseconds since 1 Jan 1970) respectively. ### Using the access token With the access token, your app can make requests to Marq APIs and get access to the user's data. Note: Access can be revoked by the user or team admin at any time if they decide that they no longer want your app to have access to the user's Marq data. To make an authenticated request, include an authorization header with your access token as a "Bearer" token. The header value should look like this: ``` Bearer ``` ### Refreshing the access token All access tokens have a brief usable lifetime (currently one hour), after which they expire. To continue accessing that user's data, your app should obtain a new token using the refresh token that was issued alongside the access token. This refresh must be performed before the token's expiration time is reached. To refresh a token, make a POST request to https://users.app.Marq.com/oauth2/refreshToken with a JSON body that looks like this: ``` { "refresh_token": "", "client_id": "", "client_secret": "", "grant_type": "refresh_token" } ``` The response will match the format of the authorization response. It will contain ``` access_token ``` ``` refresh_token ``` ``` expiresproperties ``` which hold the access token, the refresh token, and the expiration time (in milliseconds since 1 Jan 1970) respectively. **Note:** Refreshing a token **invalidates** the old access and refresh tokens. Be sure your app stores the new tokens returned in the response described above.   - [Intro to Marq](https://help.marq.com/intro-to-marq?hsLang=en#main-content) - [Getting started](https://help.marq.com/intro-to-marq?hsLang=en#getting-started) - [Tips and tricks](https://help.marq.com/intro-to-marq?hsLang=en#tips-and-tricks) - [Common issues](https://help.marq.com/intro-to-marq?hsLang=en#common-issues) - [Get support](https://help.marq.com/intro-to-marq?hsLang=en#get-support) - [Other resources](https://help.marq.com/intro-to-marq?hsLang=en#other-resources) - [Content AI](https://help.marq.com/content-ai?hsLang=en#main-content) - [AI Assistant](https://help.marq.com/content-ai?hsLang=en#ai-assistant) - [AI Marqet](https://help.marq.com/content-ai?hsLang=en#ai-marqet) - [Brand Guardian](https://help.marq.com/content-ai?hsLang=en#brand-guardian) - [Account setup and billing](https://help.marq.com/account-setup-and-billing?hsLang=en#main-content) - [Account settings](https://help.marq.com/account-setup-and-billing?hsLang=en#account-settings) - [Storage](https://help.marq.com/account-setup-and-billing?hsLang=en#storage) - [Billing and plans](https://help.marq.com/account-setup-and-billing?hsLang=en#billing-and-plans) - [Privacy and security](https://help.marq.com/account-setup-and-billing?hsLang=en#privacy-and-security) - [Creating your design](https://help.marq.com/creating-your-design?hsLang=en#main-content) - [The Editor](https://help.marq.com/creating-your-design?hsLang=en#the-editor) - [Document and page settings](https://help.marq.com/creating-your-design?hsLang=en#document-and-page-settings) - [Templates](https://help.marq.com/creating-your-design?hsLang=en#templates) - [Images](https://help.marq.com/creating-your-design?hsLang=en#images) - [Text](https://help.marq.com/creating-your-design?hsLang=en#text) - [Shapes and graphics](https://help.marq.com/creating-your-design?hsLang=en#shapes-and-graphics) - [Layers and objects](https://help.marq.com/creating-your-design?hsLang=en#layers-and-objects) - [Elements](https://help.marq.com/creating-your-design?hsLang=en#elements) - [Video and interactive objects](https://help.marq.com/creating-your-design?hsLang=en#video-and-interactive-objects) - [Tables](https://help.marq.com/creating-your-design?hsLang=en#tables) - [Locking](https://help.marq.com/creating-your-design?hsLang=en#locking) - [Uploading](https://help.marq.com/creating-your-design?hsLang=en#uploading) - [Automation and other advanced features](https://help.marq.com/creating-your-design?hsLang=en#automation-and-other-advanced-features) - [Exporting and sharing](https://help.marq.com/exporting-and-sharing?hsLang=en#main-content) - [Collaborate](https://help.marq.com/exporting-and-sharing?hsLang=en#collaborate) - [Export to social media](https://help.marq.com/exporting-and-sharing?hsLang=en#export-to-social-media) - [Embedding](https://help.marq.com/exporting-and-sharing?hsLang=en#embedding) - [Publishing](https://help.marq.com/exporting-and-sharing?hsLang=en#publishing) - [Printing](https://help.marq.com/exporting-and-sharing?hsLang=en#printing) - [Downloading](https://help.marq.com/exporting-and-sharing?hsLang=en#downloading) - [GIFs](https://help.marq.com/exporting-and-sharing?hsLang=en#gifs) - [Admin settings and team management](https://help.marq.com/admin-settings-and-team-management?hsLang=en#main-content) - [Managing your team](https://help.marq.com/admin-settings-and-team-management?hsLang=en#managing-your-team) - [Licensing and roles](https://help.marq.com/admin-settings-and-team-management?hsLang=en#licensing-and-roles) - [Brand assets](https://help.marq.com/admin-settings-and-team-management?hsLang=en#brand-assets) - [User experience and workflows](https://help.marq.com/admin-settings-and-team-management?hsLang=en#user-experience-and-workflows) - [Settings and configuration](https://help.marq.com/admin-settings-and-team-management?hsLang=en#settings-and-configuration) - [Implementation resources](https://help.marq.com/admin-settings-and-team-management?hsLang=en#implementation-resources) - [Integrations](https://help.marq.com/integrations?hsLang=en#main-content) - [Printer integrations](https://help.marq.com/integrations?hsLang=en#printer-integrations) - [Data integrations](https://help.marq.com/integrations?hsLang=en#data-integrations) - [Custom integrations](https://help.marq.com/integrations?hsLang=en#custom-integrations) - [Security and sign-on integrations](https://help.marq.com/integrations?hsLang=en#security-and-sign-on-integrations) - [Email integrations](https://help.marq.com/integrations?hsLang=en#email-integrations) - [Productivity and analytics integrations](https://help.marq.com/integrations?hsLang=en#productivity-and-analytics-integrations) - [Workflow Integrations](https://help.marq.com/integrations?hsLang=en#workflow-integrations) - [Salesforce](https://help.marq.com/integrations?hsLang=en#salesforce) - [MediaValet](https://help.marq.com/integrations?hsLang=en#mediavalet) - [Training videos](https://help.marq.com/training-videos?hsLang=en#main-content) - [View](https://help.marq.com/training-videos?hsLang=en#view) - [Courses](https://help.marq.com/courses?hsLang=en#main-content) - [View](https://help.marq.com/courses?hsLang=en#view) - [Tutorials and resources](https://help.marq.com/tutorials-and-resources?hsLang=en#main-content) - [View](https://help.marq.com/tutorials-and-resources?hsLang=en#view) - [Design services](https://help.marq.com/design-services?hsLang=en#main-content) - [View](https://help.marq.com/design-services?hsLang=en#view) - [Events](https://help.marq.com/events?hsLang=en#main-content) - [View](https://help.marq.com/events?hsLang=en#view) - [Analytics](https://help.marq.com/analytics?hsLang=en#main-content) - [Account Setup](https://help.marq.com/analytics?hsLang=en#account-setup) - [Basic Analytics](https://help.marq.com/analytics?hsLang=en#basic-analytics) - [Advanced Analytics](https://help.marq.com/analytics?hsLang=en#advanced-analytics) - [Navigating Reports](https://help.marq.com/analytics?hsLang=en#navigating-reports) - [Glossary of Terms](https://help.marq.com/analytics?hsLang=en#glossary-of-terms) - [App Marketplace](https://help.marq.com/app-marketplace?hsLang=en#main-content) - [Workflow Connectors](https://help.marq.com/app-marketplace?hsLang=en#workflow-connectors) - [Campaigns](https://help.marq.com/campaigns?hsLang=en#main-content) - [Getting Started](https://help.marq.com/campaigns?hsLang=en#getting-started) - [Connect to Facebook](https://help.marq.com/campaigns?hsLang=en#connect-to-facebook) - [Industry](https://help.marq.com/campaigns?hsLang=en#industry) - [Objectives](https://help.marq.com/campaigns?hsLang=en#objectives) - [Analytics](https://help.marq.com/campaigns?hsLang=en#analytics) - [Creator Studio](https://help.marq.com/creator-studio?hsLang=en#main-content) - [Getting Started](https://help.marq.com/creator-studio?hsLang=en#getting-started) - [Studio FAQ](https://help.marq.com/creator-studio?hsLang=en#studio-faq) - [Templates](https://help.marq.com/templates?hsLang=en#main-content) - [Getting Started](https://help.marq.com/templates?hsLang=en#getting-started) - [Advanced Features](https://help.marq.com/templates?hsLang=en#advanced-features) - [Team Management](https://help.marq.com/templates?hsLang=en#team-management) - [Troubleshooting](https://help.marq.com/templates?hsLang=en#troubleshooting) - [CRM Integrations](https://help.marq.com/crm-integrations?hsLang=en) - [DAM Integrations](https://help.marq.com/dam-integrations?hsLang=en) - [Marq 2026 Packaging Updates](https://help.marq.com/marq-2026-packaging-updates?hsLang=en) - [AI Brand Creations](https://help.marq.com/ai-brand-creations?hsLang=en) [![Chill listening crop-3](https://help.marq.com/hubfs/Brand%20Logos/marq.svg "Chill listening crop-3")](https://help.marq.com?hsLang=en) Copyright © 2026, Marq