Reseller Delete User by Email API

Allow resellers to delete user accounts using email address lookup

Reseller

Reseller Delete User by Email API

Delete user accounts using their email address. Convenient when you don't have the user's ID available.

Email Lookup

Find and delete by email.

Remove Account

Permanently delete users.

Convenient

No ID lookup required.


Endpoint Overview

MUTATION/graphql

Delete a user from your reseller group using their email address. Same functionality as Delete User by ID, but uses email for lookup.

Authentication:Bearer Token
Required scopes:reseller

Request Parameters

emailString!Required

The email address of the user to delete.


GraphQL Mutation

mutation resellerDeleteUserByEmail($email: String!) {
  resellerDeleteUserByEmail(email: $email) {
    id
    email
    username
    resellerId
  }
}

Variables:

{
  "email": "customer@example.com"
}

HTTP Request:

curl -X POST https://api.orbnet.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_RESELLER_TOKEN" \
  -d '{
    "query": "mutation resellerDeleteUserByEmail($email: String!) { resellerDeleteUserByEmail(email: $email) { id email } }",
    "variables": {
      "email": "customer@example.com"
    }
  }'

Response

200User Deleted Successfully
{
  "data": {
    "resellerDeleteUserByEmail": {
      "id": "12345",
      "email": "customer@example.com",
      "username": "deleteduser",
      "resellerId": "reseller_789"
    }
  }
}
400Email Not Found
{
  "errors": [
    {
      "message": "User with email customer@example.com not found or not in your group",
      "path": ["resellerDeleteUserByEmail"],
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}

When to Use

Customer Request

User asks to delete by email.

Support Ticket

Deletion requested in support.

Quick Removal

Skip the ID lookup step.

External Systems

Integration uses email as key.


Best Practices

Verify Email

Confirm exact email before deleting.

Double Check

Deletion is permanent and irreversible.

Consider Disable

Disable account if unsure about deletion.

Document Action

Record reason for deletion.



Permanent Deletion

User deletion is irreversible. All user data including profile, devices, and sessions will be permanently removed.

Verify User First

Look up user details before confirming deletion.

Get User by Email