We're upgrading our API

On June 6th, 2019, Mailbox API 1.0 will be sunsetted, and at that time any apps using this legacy API will no longer work. Please use Mailbox API 2.0 instead.

Person Object

Field Guide

The person object is a subset of the data representing a Customer, User or Team. The 'type' property will specify if this person is represented by a 'user', customer' or 'team'.

Name Type Example Notes
id Int 1234 Unique identifier
firstName String Jack  
lastName String Sprout  
email String jack.sprout@gmail.com  
phone String 800-555-1212 Phone is only populated when the Person is a customer associated with a Conversation of type 'phone' and a phone number was specified at the time the conversation was created.
type String user The type of person.
  • user
  • customer
  • team
photoUrl String http://www.somesite.com/images/avatar.jpg The user's photo, if one exists


    "id": 1234,
    "firstName": "Jack",
    "lastName": "Sprout",
    "email": "jack.sprout@gmail.com",
    "phone": "800-555-1212",
    "type": "user"
    "photoUrl": "http://www.somesite.com/images/avatar.jpg",