Audience

List, inspect, and revoke audience member credentials.

List audience for a server

GET

https://gateway.mewcp.com

/end-users

Returns the audience that have at least one active credential under the server identified by x-mewcp-key, sorted by most recently updated.

Authorization is your Account API Key; x-mewcp-key is that server's own API Key. The two are not interchangeable and both are required.

List audience for a server › Headers

x-mewcp-key

string · required

API Key of the business-mode server to list audience for.

List audience for a server › Responses

List of audience

EndUser[]

EndUser

externalUserId

string

Your internal identifier for this user

ExternalUserMeta

Optional metadata about the audience member. Stored alongside their credentials for display in the MewCP dashboard.

connectedProviders

string[]

List of provider slugs this user has credentials for

credentialCount

integer

lastUpdated

string · date-time

Get audience member details

GET

https://gateway.mewcp.com

/end-users/{externalUserId}

Returns an audience member's metadata and their active credential(s) under the server identified by x-mewcp-key.

Authorization is your Account API Key; x-mewcp-key is that server's own API Key. The two are not interchangeable and both are required.

Get audience member details › path Parameters

externalUserId

string · required

Your internal user identifier

Get audience member details › Headers

x-mewcp-key

string · required

API Key of the business-mode server this end-user is connected under.

Get audience member details › Responses

End-user details with credentials

externalUserId

string

ExternalUserMeta

Optional metadata about the audience member. Stored alongside their credentials for display in the MewCP dashboard.

Credential[]

GET/end-users/{externalUserId}

curl https://gateway.mewcp.com/end-users/:externalUserId \
  --header 'Authorization: <api-key>' \
  --header 'x-mewcp-key: <api-key>'

Example Responses

{
  "externalUserId": "user_abc123",
  "meta": {
    "name": "Jane Smith",
    "email": "jane@example.com"
  },
  "credentials": [
    {
      "credentialId": "8cf89a9e5054754dc3941057202aed85",
      "providerSlug": "google-gmail",
      "label": "jane@example.com",
      "authType": "oauth",
      "scopes": [
        "https://www.googleapis.com/auth/gmail.modify",
        "https://www.googleapis.com/auth/gmail.readonly",
        "https://www.googleapis.com/auth/gmail.send",
        "openid",
        "email",
        "profile"
      ],
      "expiresAt": "2026-06-03T12:58:54.185Z"
    }
  ]
}

json

application/json

Revoke an audience member's credential for a server

DELETE

https://gateway.mewcp.com

/end-users/{externalUserId}

Revokes the audience member's credential under the server identified by x-mewcp-key and permanently scrubs the stored secrets (access/refresh tokens or api keys or secrets); they cannot be recovered. The user will need to reconnect (re-authorize or resubmit their static credentials) before MCP calls on their behalf will work again.

Authorization is your Account API Key; x-mewcp-key is that server's own API Key. The two are not interchangeable and both are required.

Revoke an audience member's credential for a server › path Parameters

externalUserId

string · required

Revoke an audience member's credential for a server › Headers

x-mewcp-key

string · required

API Key of the business-mode server this end-user is connected under.

Revoke an audience member's credential for a server › Responses

Credential revoked

success

boolean

credentialId

string

Static Credentials

List audience for a server

GET

https://gateway.mewcp.com

/end-users

Returns the audience that have at least one active credential under the server identified by x-mewcp-key, sorted by most recently updated.

Authorization is your Account API Key; x-mewcp-key is that server's own API Key. The two are not interchangeable and both are required.

List audience for a server › Headers

x-mewcp-key

string · required

API Key of the business-mode server to list audience for.

List audience for a server › Responses

List of audience

EndUser[]

EndUser

externalUserId

string

Your internal identifier for this user

ExternalUserMeta

Optional metadata about the audience member. Stored alongside their credentials for display in the MewCP dashboard.

connectedProviders

string[]

List of provider slugs this user has credentials for

credentialCount

integer

lastUpdated

string · date-time

Get audience member details

GET

https://gateway.mewcp.com

/end-users/{externalUserId}

Returns an audience member's metadata and their active credential(s) under the server identified by x-mewcp-key.

Authorization is your Account API Key; x-mewcp-key is that server's own API Key. The two are not interchangeable and both are required.

Get audience member details › path Parameters

externalUserId

string · required

Your internal user identifier

Get audience member details › Headers

x-mewcp-key

string · required

API Key of the business-mode server this end-user is connected under.

Get audience member details › Responses

End-user details with credentials

externalUserId

string

ExternalUserMeta

Optional metadata about the audience member. Stored alongside their credentials for display in the MewCP dashboard.

Credential[]

Revoke an audience member's credential for a server

DELETE

https://gateway.mewcp.com

/end-users/{externalUserId}

Authorization is your Account API Key; x-mewcp-key is that server's own API Key. The two are not interchangeable and both are required.

Revoke an audience member's credential for a server › path Parameters

externalUserId

string · required

Revoke an audience member's credential for a server › Headers

x-mewcp-key

string · required

API Key of the business-mode server this end-user is connected under.

Revoke an audience member's credential for a server › Responses

Credential revoked

success

boolean

credentialId

string