Generate private Gmail Id

If gmailId is not specified, the system will randomly select from all Gmail IDs associated with your account.
Setting plus to true generates addresses with the format username+random@gmail.com, which is useful for email filtering and tracking.
All generated addresses will work with Gmail's systems and will deliver mail to your original Gmail account.
The maximum value for number may be limited based on your account type and permissions.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

gmailId

string

optional

Specifies a particular Gmail ID to use for email generation. If not provided, the system will use all Gmail IDs associated with your account.

number

integer

required

The number of email addresses to generate. This determines how many unique Gmail addresses will be returned.

Example:

plus

boolean

required

When set to true, generated addresses will include the "+" notation (e.g., username+random@gmail.com), which can be used for email filtering. When false or omitted, addresses will use standard Gmail address formats.

Default:

true

Example

{
    "gmailId": "string",
    "number": 1,
    "plus": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

code

integer

required

status

boolean

required

msg

string

required

data

object

required

items

array[string]

required

domains

array[string]

required

Example

{
    "code": 200,
    "status": true,
    "msg": "success",
    "data": {
        "items": [
            "aa.bb.cc+2gwhp1f03",
            "aa.bb.cc+oxjhqbrp",
            "aa.bb.cc+hado15fd6",
            "aa.bb.cc+wekzk7",
            "aa.bb.cc+tdic7",
            "aa.bb.cc+9520w",
            "aa.bb.cc+95u7",
            "aa.bb.cc+amk5r4i",
            "aa.bb.cc+qngyem",
            "aa.bb.cc+rhnz"
        ],
        "domains": [
            "@gmail.com",
            "@googlemail.com"
        ]
    }
}