Skip to contentSkip to navigationSkip to topbar
On this page

Profile


(warning)

This documentation is for the SendGrid Web API v2

We will deprecate this version on February 10, 2025. To access all the latest features and upcoming developments, please see our v3 API. For assistance with transitioning, refer to our migration guide.

Manage your SendGrid profile settings using our Web API.


Get

get page anchor
JSONXML

Call

GEThttps://api.sendgrid.com/api/profile.get.json
GET Dataapi_user=apikey&api_key=your_sendgrid_api_key

Response

1
[
2
{
3
"username": "sampleuseexampexample@example.com",
4
"email": "example@example.com",
5
"active": "true",
6
"first_name": "john",
7
"last_name": "doe",
8
"address": "555 any street",
9
"city": "any city",
10
"state": "CA",
11
"zip": "91234",
12
"country": "US",
13
"phone": "555-555-5555",
14
"website": "example.com"
15
}
16
]

URI ParameterRequiredRequirementsDescription
first_nameNoYour first name
last_nameNoYour last name
addressNoCompany address
cityNoCity where your company is located
stateNoState where your company is located
countryNoCountry where your company is located
zipNoZipcode where your company is located
phoneNoValid phone number where we can reach you
websiteNoCompany website
JSONXML
POSThttps://api.sendgrid.com/api/profile.set.json
POST Dataapi_user=apikey&api_key=your_sendgrid_api_key&first_name=newFirstName&last_name=&newLastName
1
{
2
"message": "success"
3
}

URI ParameterRequiredRequirementsDescription
passwordYesPlease see the SendGrid password requirementsYour new password
confirm_passwordYesMust match password parameterConfirm new password
JSONXML
POSThttps://api.sendgrid.com/api/password.set.json
POST Dataapi_user=apikey&api_key=your_sendgrid_api_key&password=newPassword&confirm_password=newPassword
1
{
2
"message": "success"
3
}

(warning)

Warning

Please note, your account username is used to login to our SMTP server and the website. Changes will take effect immediately.

URI ParameterRequiredRequirementsDescription
usernameYesMust not exceed 100 characters. The username cannot be already taken or contain the SendGrid.com domainThis is the new username we will be authenticating with our SMTP servers and our website. Changes take effect immediately
JSONXML
POSThttps://api.sendgrid.com/api/profile.setUsername.json
POST Dataapi_user=apikey&api_key=your_sendgrid_api_key&username=yournewusername@domain.com
1
{
2
"message": "success"
3
}

(information)

Info

Please note, we send out a confirmation email to the new email account in order to be validated. Your email address changes when you click on the confirmation link.

URI ParameterRequiredRequirementsDescription
emailYesMust be in email format and not more than 100 charactersThis is the new email address we will be contacting you with. Changes take effect immediately
JSONXML
POSThttps://api.sendgrid.com/api/profile.setEmail.json
POST Dataapi_user=apikey&api_key=your_sendgrid_api_key&email=yournewemail@domain.com
1
{
2
"message": "success"
3
}

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.