---
updatedAt: 2026-09-21T10:34:32.000Z
agentTools:
  projectIndex: https://developers.marq.com/llms.txt
---

# Permisssion scopes

OAuth scopes, or permissions, let you specify precisely how your application needs to access a user’s Marq account.

You should only specify the scopes you need to satisfy your use case and no more.

## User permissions

The user that authorizes your app must have permission to access the corresponding feature. For example, if the user does not have permission to view a project in Marq, then your request to the project resource will return a 403 - Forbidden status.

## Summary of all OAuth scopes

The following scopes are available for an application to obtain authorization from a user or account.

[block:parameters]
{
  "data": {
    "h-0": "Scope",
    "h-1": "Description",
    "h-2": "User",
    "h-3": "Account",
    "0-0": "`print.orders`",
    "0-1": "Allows applications to retrieve and update print orders and job statuses.",
    "0-2": "✅",
    "0-3": "",
    "1-0": "`data-service.admin` ",
    "1-1": "Allows applications to create, retrieve, and update data automation sets that are used to populate images and text inside a Marq project.",
    "1-2": "✅",
    "1-3": "✅",
    "2-0": "`project.templates `",
    "2-1": "Allows applications to retrieve and update brand template data.  \n  \n`project.templates:readonly` is minimum scope required to retrieve templates.",
    "2-2": "✅",
    "2-3": "✅",
    "3-0": "`project.content`",
    "3-1": "Allows applications to retrieve folders and projects on behalf of a user or an account.  \n  \n`project.content:readonly` is minimum scope required to retrieve projects.",
    "3-2": "✅",
    "3-3": "✅",
    "4-0": "`project.content.approval` ",
    "4-1": "Allows applications to retrieve and update project approval statuses on behalf of a user or an account.  \n  \n`project.content.approvals :readonly` is minimum scope required to retrieve project approvals without creating or updating an approval.",
    "4-2": "✅",
    "4-3": "✅",
    "5-0": "`project.content.export`",
    "5-1": "Allows applications to export projects into file types (e.g. PDF, PNG, JPG, etc.) on behalf of a user or an account.",
    "5-2": "✅",
    "5-3": "✅",
    "6-0": "`account.user`",
    "6-1": "Allows applications to create, retrieve, update, and delete users and groups in Marq via [SCIM ](https://marq.readme.io/reference/list-all-users)endpoints.",
    "6-2": "✅",
    "6-3": "✅",
    "7-0": "`offline_access`",
    "7-1": "Continue to perform authorized actions when you’re not logged in (required to refresh account tokens).",
    "7-2": "",
    "7-3": "✅",
    "8-0": "`account.webhook`",
    "8-1": "Allows  applications to register a webhook notification URL.",
    "8-2": "",
    "8-3": "✅"
  },
  "cols": 4,
  "rows": 9,
  "align": [
    "left",
    "left",
    "left",
    "left"
  ]
}
[/block]