Prospect

A descriptor of a person.

addedAt
string or null <date-time>

The date and time the prospect was added to any system.

addressCity
string or null <= 255 characters

The prospect’s city (e.g. "Seattle").

addressCountry
string or null <= 255 characters

The prospect’s country (e.g. "USA").

addressState
string or null <= 255 characters

The prospect’s state (e.g. "Washington").

addressStreet
string or null <= 255 characters

The prospect’s street address (e.g. "1441 N 34th St").

addressStreet2
string or null <= 255 characters

The prospect’s second street address, if applicable.

addressZip
string or null <= 255 characters

The prospect’s postal code (e.g. "98103").

angelListUrl
string or null <= 255 characters

The prospect’s AngelList URL.

availableAt
string or null <date-time>

The date and time the prospect is available to contact again.

callOptedOut
boolean or null

Whether the prospect is opted out of calling, or opted out in general if granular opt-out is not enabled.

callsOptStatus
string or null <= 255 characters

A string ("opted_in", "opted_out", "null") that represents whether a prospect has opted into or out of calls.

callsOptedAt
string or null <date-time>

The date and time the prospect opted in/out of calls.

campaignName
string or null <= 255 characters

The name of the campaign the prospect is associated with.

clickCount
integer or null

The number of clicks the prospect has made since the last touch point.

company
string or null

The name of the company the prospect works at. If associated with an account, this is the name of the account. (e.g. Acme International).

contactHistogram
Array of any or null <contact histogram>

The last 12 months of email contact history with the prospect, with the current month being the last element. The format for each month is '[inboundCount, outboundCount]'. Note: Retrieving this field will slow down the queries. Unless this field is required, it is best to filter it out. See Specify Sparse Fieldsets for examples

createdAt
string or null <date-time>

The date and time the prospect was created.

custom1
string or null <= 32000 characters

The value of the prospect’s first custom field.

custom2
string or null <= 32000 characters

The value of the prospect’s second custom field.

custom3
string or null <= 32000 characters

The value of the prospect’s third custom field.

custom4
string or null <= 32000 characters

The value of the prospect’s fourth custom field.

custom5
string or null <= 32000 characters

The value of the prospect’s fifth custom field.

custom6
string or null <= 32000 characters

The value of the prospect’s sixth custom field.

custom7
string or null <= 32000 characters

The value of the prospect’s seventh custom field.

custom8
string or null <= 32000 characters

The value of the prospect’s eight custom field.

custom9
string or null <= 32000 characters

The value of the prospect’s ninth custom field.

custom10
string or null <= 32000 characters

The value of the prospect’s 10th custom field.

custom11
string or null <= 32000 characters

The value of the prospect’s 11th custom field.

custom12
string or null <= 32000 characters

The value of the prospect’s 12th custom field.

custom13
string or null <= 32000 characters

The value of the prospect’s 13th custom field.

custom14
string or null <= 32000 characters

The value of the prospect’s 14th custom field.

custom15
string or null <= 32000 characters

The value of the prospect’s 15th custom field.

custom16
string or null <= 32000 characters

The value of the prospect’s 16th custom field.

custom17
string or null <= 32000 characters

The value of the prospect’s 17th custom field.

custom18
string or null <= 32000 characters

The value of the prospect’s 18th custom field.

custom19
string or null <= 32000 characters

The value of the prospect’s 19th custom field.

custom20
string or null <= 32000 characters

The value of the prospect’s 20th custom field.

custom21
string or null <= 32000 characters

The value of the prospect’s 21st custom field.

custom22
string or null <= 32000 characters

The value of the prospect’s 22nd custom field.

custom23
string or null <= 32000 characters

The value of the prospect’s 23rd custom field.

custom24
string or null <= 32000 characters

The value of the prospect’s 24th custom field.

custom25
string or null <= 32000 characters

The value of the prospect’s 25th custom field.

custom26
string or null <= 32000 characters

The value of the prospect’s 26th custom field.

custom27
string or null <= 32000 characters

The value of the prospect’s 27th custom field.

custom28
string or null <= 32000 characters

The value of the prospect’s 28th custom field.

custom29
string or null <= 32000 characters

The value of the prospect’s 29th custom field.

custom30
string or null <= 32000 characters

The value of the prospect’s 30th custom field.

custom31
string or null <= 32000 characters

The value of the prospect’s 31st custom field.

custom32
string or null <= 32000 characters

The value of the prospect’s 32nd custom field.

custom33
string or null <= 32000 characters

The value of the prospect’s 33rd custom field.

custom34
string or null <= 32000 characters

The value of the prospect’s 34th custom field.

custom35
string or null <= 32000 characters

The value of the prospect’s 35th custom field.

custom36
string or null <= 32000 characters

The value of the prospect’s 36th custom field.

custom37
string or null <= 32000 characters

The value of the prospect’s 37th custom field.

custom38
string or null <= 32000 characters

The value of the prospect’s 38th custom field.

custom39
string or null <= 32000 characters

The value of the prospect’s 39th custom field.

custom40
string or null <= 32000 characters

The value of the prospect’s 40th custom field.

custom41
string or null <= 32000 characters

The value of the prospect’s 41st custom field.

custom42
string or null <= 32000 characters

The value of the prospect’s 42nd custom field.

custom43
string or null <= 32000 characters

The value of the prospect’s 43rd custom field.

custom44
string or null <= 32000 characters

The value of the prospect’s 44th custom field.

custom45
string or null <= 32000 characters

The value of the prospect’s 45th custom field.

custom46
string or null <= 32000 characters

The value of the prospect’s 46th custom field.

custom47
string or null <= 32000 characters

The value of the prospect’s 47th custom field.

custom48
string or null <= 32000 characters

The value of the prospect’s 48th custom field.

custom49
string or null <= 32000 characters

The value of the prospect’s 49th custom field.

custom50
string or null <= 32000 characters

The value of the prospect’s 50th custom field.

custom51
string or null <= 32000 characters

The value of the prospect’s 51st custom field.

custom52
string or null <= 32000 characters

The value of the prospect’s 52nd custom field.

custom53
string or null <= 32000 characters

The value of the prospect’s 53rd custom field.

custom54
string or null <= 32000 characters

The value of the prospect’s 54th custom field.

custom55
string or null <= 32000 characters

The value of the prospect’s 55th custom field.

custom56
string or null <= 32000 characters

The value of the prospect’s 56th custom field.

custom57
string or null <= 32000 characters

The value of the prospect’s 57th custom field.

custom58
string or null <= 32000 characters

The value of the prospect’s 58th custom field.

custom59
string or null <= 32000 characters

The value of the prospect’s 59th custom field.

custom60
string or null <= 32000 characters

The value of the prospect’s 60th custom field.

custom61
string or null <= 32000 characters

The value of the prospect’s 61st custom field.

custom62
string or null <= 32000 characters

The value of the prospect’s 62nd custom field.

custom63
string or null <= 32000 characters

The value of the prospect’s 63rd custom field.

custom64
string or null <= 32000 characters

The value of the prospect’s 64th custom field.

custom65
string or null <= 32000 characters

The value of the prospect’s 65th custom field.

custom66
string or null <= 32000 characters

The value of the prospect’s 66th custom field.

custom67
string or null <= 32000 characters

The value of the prospect’s 67th custom field.

custom68
string or null <= 32000 characters

The value of the prospect’s 68th custom field.

custom69
string or null <= 32000 characters

The value of the prospect’s 69th custom field.

custom70
string or null <= 32000 characters

The value of the prospect’s 70th custom field.

custom71
string or null <= 32000 characters

The value of the prospect’s 71st custom field.

custom72
string or null <= 32000 characters

The value of the prospect’s 72nd custom field.

custom73
string or null <= 32000 characters

The value of the prospect’s 73rd custom field.

custom74
string or null <= 32000 characters

The value of the prospect’s 74th custom field.

custom75
string or null <= 32000 characters

The value of the prospect’s 75th custom field.

custom76
string or null <= 32000 characters

The value of the prospect’s 76th custom field.

custom77
string or null <= 32000 characters

The value of the prospect’s 77th custom field.

custom78
string or null <= 32000 characters

The value of the prospect’s 78th custom field.

custom79
string or null <= 32000 characters

The value of the prospect’s 79th custom field.

custom80
string or null <= 32000 characters

The value of the prospect’s 80th custom field.

custom81
string or null <= 32000 characters

The value of the prospect’s 81st custom field.

custom82
string or null <= 32000 characters

The value of the prospect’s 82nd custom field.

custom83
string or null <= 32000 characters

The value of the prospect’s 83rd custom field.

custom84
string or null <= 32000 characters

The value of the prospect’s 84th custom field.

custom85
string or null <= 32000 characters

The value of the prospect’s 85th custom field.

custom86
string or null <= 32000 characters

The value of the prospect’s 86th custom field.

custom87
string or null <= 32000 characters

The value of the prospect’s 87th custom field.

custom88
string or null <= 32000 characters

The value of the prospect’s 88th custom field.

custom89
string or null <= 32000 characters

The value of the prospect’s 89th custom field.

custom90
string or null <= 32000 characters

The value of the prospect’s 90th custom field.

custom91
string or null <= 32000 characters

The value of the prospect’s 91st custom field.

custom92
string or null <= 32000 characters

The value of the prospect’s 92nd custom field.

custom93
string or null <= 32000 characters

The value of the prospect’s 93rd custom field.

custom94
string or null <= 32000 characters

The value of the prospect’s 94th custom field.

custom95
string or null <= 32000 characters

The value of the prospect’s 95th custom field.

custom96
string or null <= 32000 characters

The value of the prospect’s 96th custom field.

custom97
string or null <= 32000 characters

The value of the prospect’s 97th custom field.

custom98
string or null <= 32000 characters

The value of the prospect’s 98th custom field.

custom99
string or null <= 32000 characters

The value of the prospect’s 99th custom field.

custom100
string or null <= 32000 characters

The value of the prospect’s 100th custom field.

custom101
string or null <= 32000 characters

The value of the prospect’s 101st custom field.

custom102
string or null <= 32000 characters

The value of the prospect’s 102nd custom field.

custom103
string or null <= 32000 characters

The value of the prospect’s 103rd custom field.

custom104
string or null <= 32000 characters

The value of the prospect’s 104th custom field.

custom105
string or null <= 32000 characters

The value of the prospect’s 105th custom field.

custom106
string or null <= 32000 characters

The value of the prospect’s 106th custom field.

custom107
string or null <= 32000 characters

The value of the prospect’s 107th custom field.

custom108
string or null <= 32000 characters

The value of the prospect’s 108th custom field.

custom109
string or null <= 32000 characters

The value of the prospect’s 109th custom field.

custom110
string or null <= 32000 characters

The value of the prospect’s 110th custom field.

custom111
string or null <= 32000 characters

The value of the prospect’s 111th custom field.

custom112
string or null <= 32000 characters

The value of the prospect’s 112th custom field.

custom113
string or null <= 32000 characters

The value of the prospect’s 113th custom field.

custom114
string or null <= 32000 characters

The value of the prospect’s 114th custom field.

custom115
string or null <= 32000 characters

The value of the prospect’s 115th custom field.

custom116
string or null <= 32000 characters

The value of the prospect’s 116th custom field.

custom117
string or null <= 32000 characters

The value of the prospect’s 117th custom field.

custom118
string or null <= 32000 characters

The value of the prospect’s 118th custom field.

custom119
string or null <= 32000 characters

The value of the prospect’s 119th custom field.

custom120
string or null <= 32000 characters

The value of the prospect’s 120th custom field.

custom121
string or null <= 32000 characters

The value of the prospect’s 121st custom field.

custom122
string or null <= 32000 characters

The value of the prospect’s 122nd custom field.

custom123
string or null <= 32000 characters

The value of the prospect’s 123rd custom field.

custom124
string or null <= 32000 characters

The value of the prospect’s 124th custom field.

custom125
string or null <= 32000 characters

The value of the prospect’s 125th custom field.

custom126
string or null <= 32000 characters

The value of the prospect’s 126th custom field.

custom127
string or null <= 32000 characters

The value of the prospect’s 127th custom field.

custom128
string or null <= 32000 characters

The value of the prospect’s 128th custom field.

custom129
string or null <= 32000 characters

The value of the prospect’s 129th custom field.

custom130
string or null <= 32000 characters

The value of the prospect’s 130th custom field.

custom131
string or null <= 32000 characters

The value of the prospect’s 131st custom field.

custom132
string or null <= 32000 characters

The value of the prospect’s 132nd custom field.

custom133
string or null <= 32000 characters

The value of the prospect’s 133rd custom field.

custom134
string or null <= 32000 characters

The value of the prospect’s 134th custom field.

custom135
string or null <= 32000 characters

The value of the prospect’s 135th custom field.

custom136
string or null <= 32000 characters

The value of the prospect’s 136th custom field.

custom137
string or null <= 32000 characters

The value of the prospect’s 137th custom field.

custom138
string or null <= 32000 characters

The value of the prospect’s 138th custom field.

custom139
string or null <= 32000 characters

The value of the prospect’s 139th custom field.

custom140
string or null <= 32000 characters

The value of the prospect’s 140th custom field.

custom141
string or null <= 32000 characters

The value of the prospect’s 141st custom field.

custom142
string or null <= 32000 characters

The value of the prospect’s 142nd custom field.

custom143
string or null <= 32000 characters

The value of the prospect’s 143rd custom field.

custom144
string or null <= 32000 characters

The value of the prospect’s 144th custom field.

custom145
string or null <= 32000 characters

The value of the prospect’s 145th custom field.

custom146
string or null <= 32000 characters

The value of the prospect’s 146th custom field.

custom147
string or null <= 32000 characters

The value of the prospect’s 147th custom field.

custom148
string or null <= 32000 characters

The value of the prospect’s 148th custom field.

custom149
string or null <= 32000 characters

The value of the prospect’s 149th custom field.

custom150
string or null <= 32000 characters

The value of the prospect’s 150th custom field.

dateOfBirth
string or null <date>

The date the prospect was born.

degree
string or null <= 255 characters

The degree(s) the prospect has received.

emailOptedOut
boolean or null

Whether the prospect is opted out of email, or opted out in general if granular opt-out is not enabled.

emails
Array of strings or null <email>

A list of email addresses associated with the prospect.

emailsOptStatus
string or null <= 255 characters

A string ("opted_in", "opted_out", "null") that represents whether a prospect has opted into or out of emails.

emailsOptedAt
string or null <date-time>

The date and time the prospect opted in/out of emails.

engagedAt
string or null <date-time>

The date and time the prospect last engaged.

engagedScore
number or null <float>

A number representing the quality of the lead, based on the number of the prospect’s opens, clicks and mailing replies.

eventName
string or null <= 255 characters

The name of the event the prospect was met at.

externalId
string or null <= 255 characters

A custom ID for the prospect, often referencing an ID in an external system.

externalOwner
string or null <= 255 characters

A custom owner for the prospect, often referencing an ownering in an external system.

externalSource
string or null <= 255 characters

The source of the resource’s creation (e.g. "outreach-api").

facebookUrl
string or null <= 255 characters

The prospect’s Facebook URL.

firstName
string or null <= 255 characters

The first name of the prospect.

gender
string or null <= 255 characters

The gender of the prospect.

githubUrl
string or null <= 1000 characters

The prospect’s GitHub URL.

githubUsername
string or null <= 255 characters

The prospect’s GitHub username.

googlePlusUrl
string or null <= 255 characters

The prospect’s Google+ URL.

graduationDate
string or null <date>

The graduation date of the prospect.

homePhones
Array of strings or null

A list of home phone numbers associated with the prospect.

jobStartDate
string or null <date>

The starting date of the prospect’s current job.

lastName
string or null <= 255 characters

The last name of the prospect.

linkedInConnections
integer or null

The number of connections on the prospect’s LinkedIn profile.

linkedInId
string or null <= 255 characters

The prospect’s LinkedIn ID.

linkedInSlug
string or null <= 255 characters

The prospect’s LinkedIn slug.

linkedInUrl
string or null <= 1000 characters

The prospect’s LinkedIn URL.

middleName
string or null <= 255 characters

The middle name of the prospect.

mobilePhones
Array of strings or null

A list of mobile phone numbers associated with the prospect.

name
string or null

The full name of the prospect.

nickname
string or null <= 255 characters

The nickname of the prospect.

occupation
string or null <= 255 characters

The occupation of the prospect (e.g. "Purchasing Manager").

openCount
integer or null

The number of opens the prospect has made since the last touch point.

optedOut
boolean or null

A boolean value representing whether this prospect is currently opted out of all mailings. Set this value to true to opt out the prospect; the 'opted_out' timestamp will be updated to the time of the request. Set this value to false to revert the opt at and clear the opted out timestamp.

optedOutAt
string or null <date-time>

The date and time the prospect opted out of emails.

otherPhones
Array of strings or null

A list of other phone numbers associated with the prospect.

personalNote1
string or null <= 65535 characters

A custom note field related to the prospect.

personalNote2
string or null <= 65535 characters

A second note field related to the prospect.

preferredContact
string or null <= 255 characters

The preferred contact method for the prospect.

quoraUrl
string or null <= 255 characters

The prospect’s Quora URL.

region
string or null <= 255 characters

The primary geographic region of the prospect.

replyCount
integer or null

The number of replies the prospect has made since the last touch point.

school
string or null <= 255 characters

The school(s) the prospect has attended.

score
number or null <float>

A custom score given to measure the quality of the lead.

sharingTeamId
string or null <= 255 characters

The ID of the sharing team associated with this object. Access is currently in beta.

source
string or null <= 255 characters

A custom source representing where the lead was first acquired.

specialties
string or null <= 65535 characters

A description of the prospect’s specialties.

stackOverflowId
string or null <= 255 characters

The prospect’s StackOverflow ID.

stackOverflowUrl
string or null <= 1000 characters

The prospect’s StackOverflow URL.

tags
Array of strings or null

A list of tag values associated with the account (e.g. ["Interested", "2017 Expo"]).

timeZone
string or null <= 255 characters

The prospect’s current timezone, preferably in the IANA format (e.g. "America/LosAngeles").

timeZoneIana
string or null

The prospect’s current IANA timezone, if available.

timeZoneInferred
string or null <= 255 characters

The prospect’s current inferred IANA timezone, if available.

title
string or null <= 255 characters

The title of the prospect.

touchedAt
string or null <date-time>

The date and time the prospect was last touched.

trashedAt
string or null <date-time>

The date a prospect was soft deleted.

twitterUrl
string or null <= 1000 characters

The prospect’s Twitter URL.

twitterUsername
string or null <= 255 characters

The prospect’s Twitter username.

updatedAt
string or null <date-time>

The date and time the prospect was last updated.

voipPhones
Array of strings or null

A list of voip phone numbers associated with the prospect.

websiteUrl1
string or null <= 65535 characters

The URL of the prospect’s website.

websiteUrl2
string or null <= 65535 characters

The value of the prospect’s second website URL field.

websiteUrl3
string or null <= 65535 characters

The value of the prospect’s third website URL field.

workPhones
Array of strings or null

A list of work phone numbers associated with the prospect.

{
  • "addedAt": "2019-08-24T14:15:22Z",
  • "addressCity": "string",
  • "addressCountry": "string",
  • "addressState": "string",
  • "addressStreet": "string",
  • "addressStreet2": "string",
  • "addressZip": "string",
  • "angelListUrl": "string",
  • "availableAt": "2019-08-24T14:15:22Z",
  • "callOptedOut": true,
  • "callsOptStatus": "string",
  • "callsOptedAt": "2019-08-24T14:15:22Z",
  • "campaignName": "string",
  • "clickCount": 0,
  • "company": "string",
  • "contactHistogram": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "custom1": "string",
  • "custom2": "string",
  • "custom3": "string",
  • "custom4": "string",
  • "custom5": "string",
  • "custom6": "string",
  • "custom7": "string",
  • "custom8": "string",
  • "custom9": "string",
  • "custom10": "string",
  • "custom11": "string",
  • "custom12": "string",
  • "custom13": "string",
  • "custom14": "string",
  • "custom15": "string",
  • "custom16": "string",
  • "custom17": "string",
  • "custom18": "string",
  • "custom19": "string",
  • "custom20": "string",
  • "custom21": "string",
  • "custom22": "string",
  • "custom23": "string",
  • "custom24": "string",
  • "custom25": "string",
  • "custom26": "string",
  • "custom27": "string",
  • "custom28": "string",
  • "custom29": "string",
  • "custom30": "string",
  • "custom31": "string",
  • "custom32": "string",
  • "custom33": "string",
  • "custom34": "string",
  • "custom35": "string",
  • "custom36": "string",
  • "custom37": "string",
  • "custom38": "string",
  • "custom39": "string",
  • "custom40": "string",
  • "custom41": "string",
  • "custom42": "string",
  • "custom43": "string",
  • "custom44": "string",
  • "custom45": "string",
  • "custom46": "string",
  • "custom47": "string",
  • "custom48": "string",
  • "custom49": "string",
  • "custom50": "string",
  • "custom51": "string",
  • "custom52": "string",
  • "custom53": "string",
  • "custom54": "string",
  • "custom55": "string",
  • "custom56": "string",
  • "custom57": "string",
  • "custom58": "string",
  • "custom59": "string",
  • "custom60": "string",
  • "custom61": "string",
  • "custom62": "string",
  • "custom63": "string",
  • "custom64": "string",
  • "custom65": "string",
  • "custom66": "string",
  • "custom67": "string",
  • "custom68": "string",
  • "custom69": "string",
  • "custom70": "string",
  • "custom71": "string",
  • "custom72": "string",
  • "custom73": "string",
  • "custom74": "string",
  • "custom75": "string",
  • "custom76": "string",
  • "custom77": "string",
  • "custom78": "string",
  • "custom79": "string",
  • "custom80": "string",
  • "custom81": "string",
  • "custom82": "string",
  • "custom83": "string",
  • "custom84": "string",
  • "custom85": "string",
  • "custom86": "string",
  • "custom87": "string",
  • "custom88": "string",
  • "custom89": "string",
  • "custom90": "string",
  • "custom91": "string",
  • "custom92": "string",
  • "custom93": "string",
  • "custom94": "string",
  • "custom95": "string",
  • "custom96": "string",
  • "custom97": "string",
  • "custom98": "string",
  • "custom99": "string",
  • "custom100": "string",
  • "custom101": "string",
  • "custom102": "string",
  • "custom103": "string",
  • "custom104": "string",
  • "custom105": "string",
  • "custom106": "string",
  • "custom107": "string",
  • "custom108": "string",
  • "custom109": "string",
  • "custom110": "string",
  • "custom111": "string",
  • "custom112": "string",
  • "custom113": "string",
  • "custom114": "string",
  • "custom115": "string",
  • "custom116": "string",
  • "custom117": "string",
  • "custom118": "string",
  • "custom119": "string",
  • "custom120": "string",
  • "custom121": "string",
  • "custom122": "string",
  • "custom123": "string",
  • "custom124": "string",
  • "custom125": "string",
  • "custom126": "string",
  • "custom127": "string",
  • "custom128": "string",
  • "custom129": "string",
  • "custom130": "string",
  • "custom131": "string",
  • "custom132": "string",
  • "custom133": "string",
  • "custom134": "string",
  • "custom135": "string",
  • "custom136": "string",
  • "custom137": "string",
  • "custom138": "string",
  • "custom139": "string",
  • "custom140": "string",
  • "custom141": "string",
  • "custom142": "string",
  • "custom143": "string",
  • "custom144": "string",
  • "custom145": "string",
  • "custom146": "string",
  • "custom147": "string",
  • "custom148": "string",
  • "custom149": "string",
  • "custom150": "string",
  • "dateOfBirth": "2019-08-24",
  • "degree": "string",
  • "emailOptedOut": true,
  • "emails": [
    ],
  • "emailsOptStatus": "string",
  • "emailsOptedAt": "2019-08-24T14:15:22Z",
  • "engagedAt": "2019-08-24T14:15:22Z",
  • "engagedScore": 0,
  • "eventName": "string",
  • "externalId": "string",
  • "externalOwner": "string",
  • "externalSource": "string",
  • "facebookUrl": "string",
  • "firstName": "string",
  • "gender": "string",
  • "githubUrl": "string",
  • "githubUsername": "string",
  • "googlePlusUrl": "string",
  • "graduationDate": "2019-08-24",
  • "homePhones": [
    ],
  • "jobStartDate": "2019-08-24",
  • "lastName": "string",
  • "linkedInConnections": 0,
  • "linkedInId": "string",
  • "linkedInSlug": "string",
  • "linkedInUrl": "string",
  • "middleName": "string",
  • "mobilePhones": [
    ],
  • "name": "string",
  • "nickname": "string",
  • "occupation": "string",
  • "openCount": 0,
  • "optedOut": true,
  • "optedOutAt": "2019-08-24T14:15:22Z",
  • "otherPhones": [
    ],
  • "personalNote1": "string",
  • "personalNote2": "string",
  • "preferredContact": "string",
  • "quoraUrl": "string",
  • "region": "string",
  • "replyCount": 0,
  • "school": "string",
  • "score": 0,
  • "sharingTeamId": "string",
  • "source": "string",
  • "specialties": "string",
  • "stackOverflowId": "string",
  • "stackOverflowUrl": "string",
  • "tags": [
    ],
  • "timeZone": "string",
  • "timeZoneIana": "string",
  • "timeZoneInferred": "string",
  • "title": "string",
  • "touchedAt": "2019-08-24T14:15:22Z",
  • "trashedAt": "2019-08-24T14:15:22Z",
  • "twitterUrl": "string",
  • "twitterUsername": "string",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "voipPhones": [
    ],
  • "websiteUrl1": "string",
  • "websiteUrl2": "string",
  • "websiteUrl3": "string",
  • "workPhones": [
    ]
}

Prospect Relationships

object

The prospect's associated account. You can use attributes id, customId, name, named and updatedAt to filter prospects by account (e.g. filter[account][id]=X).

object

The non-finished sequence states where this prospect is the primary recipient. This includes states of "active", "paused", "failed", "bounced", "pending" and "disabled." You can use attributes id and state to filter prospects by activeSequenceStates (e.g. filter[activeSequenceStates][id]=X).

object
object
object

The batches associated with the prospect.

object

The calls associated with the prospect. Relationship calls cannot be used as a filter.

object

The creater of the prospect. Relationship creator cannot be used as a filter.

object

The default plugin mapping associated with the prospect. If no plugin mapping is enabled, it will return the first plugin mapping associated with the prospect.

object

The prospect's email addresses. Relationship emailAddresses cannot be used as a filter.

object

The prospect's favorites. Relationship favorites cannot be used as a filter.

object

The mailings associated with the prospect. Relationship mailings cannot be used as a filter.

object

The opportunities associated with the prospect. Requires the Opportunities SKU to be enabled in order to have access. Please contact support@outreach.io for more assistance. You can use only the attribute id to filter prospects by opportunities (e.g. filter[opportunities][id]=X).

object

The roles that associate the prospect with opportunities. Relationship opportunityProspectRoles cannot be used as a filter.

object

The owner of the prospect. You can use only the attribute id to filter prospects by owner (e.g. filter[owner][id]=X).

object

The persona of the prospect, if it has one. You can use only the attribute id to filter prospects by persona (e.g. filter[persona][id]=X).

object

The prospect's phone numbers Relationship phoneNumbers cannot be used as a filter.

object

The sequence states where this prospect is the primary recipient. You can use attributes id and state to filter prospects by sequenceStates (e.g. filter[sequenceStates][id]=X).

object

The stage the prospect is in. You can use attributes id and name to filter prospects by stage (e.g. filter[stage][id]=X).

object

The tasks associated with the prospect. Relationship tasks cannot be used as a filter.

object

The account that soft deleted this prospect.

object

The most recent updater of the prospect. Relationship updater cannot be used as a filter.

{}

Prospect Resource Metadata

METADATA NAME DESCRIPTION QUERY PARAM
canWrite A boolean value indicating whether the current API user has write access to this resource. provideAuthorizationMeta
canDelete A boolean value indicating whether the current API user has delete access to this resource. provideAuthorizationMeta
dataConnections The set of connections a given Prospect has to external sources. provideDataConnections

⌵ Prospect Actions

Get a Collection of Prospects

SecuritybearerAuth and s2sAuthToken
Responses
200

OK

422

JSON error message

get/prospects
Request samples
Response samples
application/vnd.api+json
{
  • "data": [
    ]
}

Create a New Prospect

SecuritybearerAuth and s2sAuthToken
Request
Request Body schema: application/vnd.api+json
required
object
Responses
201

Created

422

JSON error message

post/prospects
Request samples
application/vnd.api+json
{
  • "data": {
    }
}
Response samples
application/vnd.api+json
{
  • "data": {
    }
}

Delete an Existing Prospect by ID

SecuritybearerAuth and s2sAuthToken
Request
path Parameters
id
required
integer
Responses
204

Deleted

422

JSON error message

delete/prospects/{id}
Request samples
Response samples
application/vnd.api+json
{
  • "errors": [
    ]
}

Get a Prospect by ID

SecuritybearerAuth and s2sAuthToken
Request
path Parameters
id
required
integer
Responses
200

OK

404

Not Found

get/prospects/{id}
Request samples
Response samples
application/vnd.api+json
{
  • "data": {
    }
}

Update a Prospect

SecuritybearerAuth and s2sAuthToken
Request
path Parameters
id
required
integer
Request Body schema: application/vnd.api+json
required
object
Responses
200

OK

422

JSON error message

patch/prospects/{id}
Request samples
application/vnd.api+json
{
  • "data": {
    }
}
Response samples
application/vnd.api+json
{
  • "data": {
    }
}