Marketo Engage Identity API

The Marketo Engage token endpoint. A two-legged OAuth 2.0 client-credentials grant issues a bearer access token with a 3,600-second lifetime, scoped to a single LaunchPoint Custom Service and inheriting that service's API-Only user's role permissions. Support for passing the token as the access_token query parameter is removed on 2026-08-31; the Authorization header is the only supported transport thereafter.

OpenAPI Specification

marketo-identity-openapi-original.json Raw ↑
{
    "swagger": "2.0",
    "info":{"description":"Marketo Engage Rest API","version":"1.0","title":"Marketo Engage Rest API","termsOfService":"https://www.adobe.com/legal.html","contact":{"name":"Adobe Developer Relations","url":"https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/home","email":""},
    "license":{"name":"API License Agreement","url":"https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/api-license"}},
    "host":"localhost:8080",
    "basePath":"/",
    "schemes": ["https"],	
    "tags":[{"name":"Identity","description":"Identity Controller"}],
    "paths": {
        "/identity/oauth/token": {
            "get": {
                "tags":["Identity"],
                "summary":"Identity",
                "description": "Retrieve an access token from Marketo Engage. Calls to this endpoint are not counted towards API call limit.\n",
                "operationId":"identityUsingGET",
                "x-badges": [
                  {
                    "name": "MCP",
                    "position": "before",
                    "color": "#2D9D78"
                  }
                ],
                "consumes":["application/json"],
                "produces":["application/json"],
                "parameters": [
                    {
                        "name": "client_id",
                        "in": "query",
                        "description": "Client ID from Admin > Integration > Launchpoint menu.",
                        "type": "string",
                        "format": "string",
                        "required": true
                    },
                    {
                        "name": "client_secret",
                        "in": "query",
                        "description": "Client Secret from Admin > Integration > Launchpoint menu.",
                        "type": "string",
                        "format": "string",
                        "required": true						
                    },
                    {
                        "name": "grant_type",
                        "in": "query",
                        "description": "Grant type.",
                        "type": "string",
                        "format": "string",
                        "enum": [
                            "client_credentials"
                        ],
                        "required": true						
                    }
                ],
  				"responses": {
					"200": {
						"description": "OK",
						"schema": {
							"$ref": "#/definitions/ResponseOfIdentity"
						}
					} 
                }
            },
            "post": {
                "tags":["Identity"],
                "summary":"Identity",
                "description": "Retrieve an access token from Marketo. Calls to this endpoint are not counted towards API call limit.\n",
                "operationId":"identityUsingPOST",
                "x-badges": [
                  {
                    "name": "MCP",
                    "position": "before",
                    "color": "#2D9D78"
                  }
                ],
                "consumes":["application/json"],
                "produces":["application/json"],
                "parameters": [
                    {
                        "name": "client_id",
                        "in": "query",
                        "description": "Client ID from Admin > Integration > Launchpoint menu.",
                        "type": "string",
                        "format": "string",
                        "required": true
                    },
                    {
                        "name": "client_secret",
                        "in": "query",
                        "description": "Client Secret from Admin > Integration > Launchpoint menu.",
                        "type": "string",
                        "format": "string",
                        "required": true						
                    },
                    {
                        "name": "grant_type",
                        "in": "query",
                        "description": "Grant type.",
                        "type": "string",
                        "format": "string",
                        "enum": [
                            "client_credentials"
                        ],
                        "required": true						
                    }
                ],
  				"responses": {
					"200": {
						"description": "OK",
						"schema": {
							"$ref": "#/definitions/ResponseOfIdentity"
						}
					} 
                }
			}
		}
    },
	"definitions": {
		"IdentityRequest": {
			"type": "object",
			"required": [
				"client_id",
				"client_secret",
				"grant_type"			
			],
			"properties": {
				"client_id": {
				  "type": "string",
				  "description": "Client ID from Admin > Integration > Launchpoint menu"
				},			  
				"client_secret": {
				  "type": "string",
				  "description": "Client Secret from Admin > Integration > Launchpoint menu"
				},		  
				"grant_type": {
				  "type": "string",
				  "description": "Grant type",
					"enum": [
							"client_credentials"
					]					  
				}	  			
			}
		},
		"ResponseOfIdentity": {
			"type": "object",
			"required": [
					"access_token",
					"scope",
					"expires_in",
					"token_type"								
			],			
			"properties": {
				"access_token": {
					"description": "The token that you pass with subsequent calls to authenticate with the target instance",
					"type": "string"
				},
				"scope": {
					"description": "The owning API-only user of the custom service that was used to authenticate",
					"type": "string"
				},
				"expires_in": {
					"description": "Remaining lifespan of the current token in seconds",									
					"type": "integer"
				},
				"token_type": {
					"description": "The OAuth authentication method",																		
					"type": "string",
					"enum": [
						"bearer"
					]
				}
			}			
		}

	}
}