People

The people endpoint gives access to the people in the CRM.

Good to know:

A person must always contain a familyname

Create a new person

post

Creates a person with emails, phone numbers, and metadata.

Authorizations

Body

Represents a CRM contact person with details like name, email, phone, and tags.

familyNamestring | nullRequired

givenNamestring | nullOptional

additionalNamestring | nullOptional

initialsstring | nullOptional

customerIdstring | nullOptional

honorificPrefixstring | nullOptional

isTrackedboolean | nullOptional

linkedinIdstring | nullOptional

externalSourcestring | nullOptional

createdAtstring | nullRead-onlyOptional

updatedAtstring | nullRead-onlyOptional

importedAtstring | nullRead-onlyOptional

archivedAtstring | nullOptional

ownerstring | nullOptionalExample: /users/{id}

jobTitlestring | nullOptional

tagsstring · iri-reference[]OptionalExample: ["/tags/{id}"]

segmentsstring · iri-reference[]OptionalExample: ["/segments/{id}"]

organizationsstring · iri-reference[]OptionalExample: ["/organizations/{id}"]

avatarUrlstring | nullRead-onlyOptional

avatarstring | nullWrite-onlyOptionalExample: /media_objects/{id}

dealSizeinteger | nullOptional

totalDealsinteger | nullOptional

totalLostDealsinteger | nullOptional

totalWonDealsinteger | nullOptional

linkedinEnrichmentarray | nullRead-onlyOptional

idstring | nullOptional

Responses

201

Person resource created

400

Invalid input

403

Forbidden

422

An error occurred

post

/people

POST /people HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/ld+json
Accept: */*
Content-Length: 599

{
  "familyName": null,
  "givenName": null,
  "additionalName": null,
  "initials": null,
  "customerId": null,
  "honorificPrefix": null,
  "isTracked": null,
  "linkedinId": null,
  "externalSource": null,
  "archivedAt": null,
  "owner": "/users/{id}",
  "jobTitle": null,
  "tags": [
    "/tags/{id}"
  ],
  "segments": [
    "/segments/{id}"
  ],
  "organizations": [
    "/organizations/{id}"
  ],
  "emailAddresses": [
    {
      "email": null
    }
  ],
  "phoneNumbers": [
    {
      "phoneNumber": null,
      "phoneType": "fax"
    }
  ],
  "address": {
    "city": null,
    "postalCode": null,
    "street": null,
    "country": "NL"
  },
  "avatar": "/media_objects/{id}",
  "dealSize": null,
  "totalDeals": null,
  "totalLostDeals": null,
  "totalWonDeals": null,
  "id": null
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "familyName": null,
  "givenName": null,
  "additionalName": null,
  "initials": null,
  "customerId": null,
  "honorificPrefix": null,
  "isTracked": null,
  "linkedinId": null,
  "externalSource": null,
  "createdAt": null,
  "updatedAt": null,
  "importedAt": null,
  "archivedAt": null,
  "owner": "/users/{id}",
  "jobTitle": null,
  "tags": [
    "/tags/{id}"
  ],
  "segments": [
    "/segments/{id}"
  ],
  "organizations": [
    "/organizations/{id}"
  ],
  "emailAddresses": [
    {
      "email": null
    }
  ],
  "phoneNumbers": [
    {
      "phoneNumber": null,
      "phoneType": "fax"
    }
  ],
  "address": {
    "city": null,
    "postalCode": null,
    "street": null,
    "country": "NL"
  },
  "avatarUrl": null,
  "dealSize": null,
  "totalDeals": null,
  "totalLostDeals": null,
  "totalWonDeals": null,
  "linkedinEnrichment": [
    null
  ],
  "id": null
}

List people

get

Retrieve a paginated list of people.

Authorizations

Query parameters

pageintegerOptional

The collection page number

Default: 1

itemsPerPageinteger · max: 30Optional

The number of items per page

Default: 15

qstringOptional

owner.idstringOptional

owner.id[]string[]Optional

emailAddresses.emailstringOptional

emailAddresses.email[]string[]Optional

tags.idstringOptional

tags.id[]string[]Optional

segments.uuidstringOptional

segments.uuid[]string[]Optional

exists[archivedAt]booleanOptional

order[familyName]string · enumOptionalPossible values:

order[createdAt]string · enumOptionalPossible values:

createdAt[strictly_after]stringOptional

createdAt[after]stringOptional

createdAt[strictly_before]stringOptional

createdAt[before]stringOptional

identifiersstringOptional

Filter by identifiers (searches LinkedIn IDs, email addresses, and phone numbers)

identifiers[]stringOptional

Filter by multiple identifiers

viewstring · enumOptional

Filter parameter to specify the view. To get only UUIDs, use 'idx'.

Possible values:

Responses

200

Person collection

403

Forbidden

get

/people

GET /people HTTP/1.1
Host: api.rogerroger.io
Accept: */*

{
  "member": [
    {
      "@context": "text",
      "@id": "text",
      "@type": "text",
      "familyName": null,
      "givenName": null,
      "additionalName": null,
      "initials": null,
      "customerId": null,
      "honorificPrefix": null,
      "isTracked": null,
      "linkedinId": null,
      "externalSource": null,
      "createdAt": null,
      "updatedAt": null,
      "importedAt": null,
      "archivedAt": null,
      "owner": "/users/{id}",
      "jobTitle": null,
      "tags": [
        "/tags/{id}"
      ],
      "segments": [
        "/segments/{id}"
      ],
      "organizations": [
        "/organizations/{id}"
      ],
      "emailAddresses": [
        {
          "email": null
        }
      ],
      "phoneNumbers": [
        {
          "phoneNumber": null,
          "phoneType": "fax"
        }
      ],
      "address": {
        "city": null,
        "postalCode": null,
        "street": null,
        "country": "NL"
      },
      "avatarUrl": null,
      "dealSize": null,
      "totalDeals": null,
      "totalLostDeals": null,
      "totalWonDeals": null,
      "linkedinEnrichment": [
        null
      ],
      "id": null
    }
  ],
  "totalItems": 1,
  "view": {
    "@id": "string",
    "type": "string",
    "first": "string",
    "last": "string",
    "previous": "string",
    "next": "string"
  },
  "search": {
    "@type": "text",
    "template": "text",
    "variableRepresentation": "text",
    "mapping": [
      {
        "@type": "text",
        "variable": "text",
        "property": null,
        "required": true
      }
    ]
  }
}

Retrieve a person

get

Get a single person by ID.

Authorizations

Path parameters

idstringRequired

Person identifier

Responses

200

Person resource

403

Forbidden

404

Not found

get

/people/{id}

GET /people/{id} HTTP/1.1
Host: api.rogerroger.io
Accept: */*

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "familyName": null,
  "givenName": null,
  "additionalName": null,
  "initials": null,
  "customerId": null,
  "honorificPrefix": null,
  "isTracked": null,
  "linkedinId": null,
  "externalSource": null,
  "createdAt": null,
  "updatedAt": null,
  "importedAt": null,
  "archivedAt": null,
  "owner": "/users/{id}",
  "jobTitle": null,
  "tags": [
    "/tags/{id}"
  ],
  "segments": [
    "/segments/{id}"
  ],
  "organizations": [
    "/organizations/{id}"
  ],
  "emailAddresses": [
    {
      "email": null
    }
  ],
  "phoneNumbers": [
    {
      "phoneNumber": null,
      "phoneType": "fax"
    }
  ],
  "address": {
    "city": null,
    "postalCode": null,
    "street": null,
    "country": "NL"
  },
  "avatarUrl": null,
  "dealSize": null,
  "totalDeals": null,
  "totalLostDeals": null,
  "totalWonDeals": null,
  "linkedinEnrichment": [
    null
  ],
  "id": null
}

Update a person

put

Replaces all fields of a person.

Authorizations

Path parameters

idstringRequired

Person identifier

Body

Represents a CRM contact person with details like name, email, phone, and tags.

familyNamestring | nullRequired

givenNamestring | nullOptional

additionalNamestring | nullOptional

initialsstring | nullOptional

customerIdstring | nullOptional

honorificPrefixstring | nullOptional

isTrackedboolean | nullOptional

linkedinIdstring | nullOptional

externalSourcestring | nullOptional

createdAtstring | nullRead-onlyOptional

updatedAtstring | nullRead-onlyOptional

importedAtstring | nullRead-onlyOptional

archivedAtstring | nullOptional

ownerstring | nullOptionalExample: /users/{id}

jobTitlestring | nullOptional

tagsstring · iri-reference[]OptionalExample: ["/tags/{id}"]

segmentsstring · iri-reference[]OptionalExample: ["/segments/{id}"]

organizationsstring · iri-reference[]OptionalExample: ["/organizations/{id}"]

avatarUrlstring | nullRead-onlyOptional

avatarstring | nullWrite-onlyOptionalExample: /media_objects/{id}

dealSizeinteger | nullOptional

totalDealsinteger | nullOptional

totalLostDealsinteger | nullOptional

totalWonDealsinteger | nullOptional

linkedinEnrichmentarray | nullRead-onlyOptional

idstring | nullOptional

Responses

200

Person resource updated

400

Invalid input

403

Forbidden

404

Not found

422

An error occurred

put

/people/{id}

PUT /people/{id} HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/ld+json
Accept: */*
Content-Length: 599

{
  "familyName": null,
  "givenName": null,
  "additionalName": null,
  "initials": null,
  "customerId": null,
  "honorificPrefix": null,
  "isTracked": null,
  "linkedinId": null,
  "externalSource": null,
  "archivedAt": null,
  "owner": "/users/{id}",
  "jobTitle": null,
  "tags": [
    "/tags/{id}"
  ],
  "segments": [
    "/segments/{id}"
  ],
  "organizations": [
    "/organizations/{id}"
  ],
  "emailAddresses": [
    {
      "email": null
    }
  ],
  "phoneNumbers": [
    {
      "phoneNumber": null,
      "phoneType": "fax"
    }
  ],
  "address": {
    "city": null,
    "postalCode": null,
    "street": null,
    "country": "NL"
  },
  "avatar": "/media_objects/{id}",
  "dealSize": null,
  "totalDeals": null,
  "totalLostDeals": null,
  "totalWonDeals": null,
  "id": null
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "familyName": null,
  "givenName": null,
  "additionalName": null,
  "initials": null,
  "customerId": null,
  "honorificPrefix": null,
  "isTracked": null,
  "linkedinId": null,
  "externalSource": null,
  "createdAt": null,
  "updatedAt": null,
  "importedAt": null,
  "archivedAt": null,
  "owner": "/users/{id}",
  "jobTitle": null,
  "tags": [
    "/tags/{id}"
  ],
  "segments": [
    "/segments/{id}"
  ],
  "organizations": [
    "/organizations/{id}"
  ],
  "emailAddresses": [
    {
      "email": null
    }
  ],
  "phoneNumbers": [
    {
      "phoneNumber": null,
      "phoneType": "fax"
    }
  ],
  "address": {
    "city": null,
    "postalCode": null,
    "street": null,
    "country": "NL"
  },
  "avatarUrl": null,
  "dealSize": null,
  "totalDeals": null,
  "totalLostDeals": null,
  "totalWonDeals": null,
  "linkedinEnrichment": [
    null
  ],
  "id": null
}

Partially update a person

patch

Updates specific fields of an existing person.

Authorizations

Path parameters

idstringRequired

Person identifier

Body

Represents a CRM contact person with details like name, email, phone, and tags.

familyNamestring | nullOptional

givenNamestring | nullOptional

additionalNamestring | nullOptional

initialsstring | nullOptional

customerIdstring | nullOptional

honorificPrefixstring | nullOptional

isTrackedboolean | nullOptional

linkedinIdstring | nullOptional

externalSourcestring | nullOptional

createdAtstring | nullRead-onlyOptional

updatedAtstring | nullRead-onlyOptional

importedAtstring | nullRead-onlyOptional

archivedAtstring | nullOptional

ownerstring | nullOptionalExample: /users/{id}

jobTitlestring | nullOptional

tagsstring · iri-reference[]OptionalExample: ["/tags/{id}"]

segmentsstring · iri-reference[]OptionalExample: ["/segments/{id}"]

organizationsstring · iri-reference[]OptionalExample: ["/organizations/{id}"]

avatarUrlstring | nullRead-onlyOptional

avatarstring | nullWrite-onlyOptionalExample: /media_objects/{id}

dealSizeinteger | nullOptional

totalDealsinteger | nullOptional

totalLostDealsinteger | nullOptional

totalWonDealsinteger | nullOptional

linkedinEnrichmentarray | nullRead-onlyOptional

idstring | nullOptional

Responses

200

Person resource updated

400

Invalid input

403

Forbidden

404

Not found

422

An error occurred

patch

/people/{id}

PATCH /people/{id} HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/merge-patch+json
Accept: */*
Content-Length: 599

{
  "familyName": null,
  "givenName": null,
  "additionalName": null,
  "initials": null,
  "customerId": null,
  "honorificPrefix": null,
  "isTracked": null,
  "linkedinId": null,
  "externalSource": null,
  "archivedAt": null,
  "owner": "/users/{id}",
  "jobTitle": null,
  "tags": [
    "/tags/{id}"
  ],
  "segments": [
    "/segments/{id}"
  ],
  "organizations": [
    "/organizations/{id}"
  ],
  "emailAddresses": [
    {
      "email": null
    }
  ],
  "phoneNumbers": [
    {
      "phoneNumber": null,
      "phoneType": "fax"
    }
  ],
  "address": {
    "city": null,
    "postalCode": null,
    "street": null,
    "country": "NL"
  },
  "avatar": "/media_objects/{id}",
  "dealSize": null,
  "totalDeals": null,
  "totalLostDeals": null,
  "totalWonDeals": null,
  "id": null
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "familyName": null,
  "givenName": null,
  "additionalName": null,
  "initials": null,
  "customerId": null,
  "honorificPrefix": null,
  "isTracked": null,
  "linkedinId": null,
  "externalSource": null,
  "createdAt": null,
  "updatedAt": null,
  "importedAt": null,
  "archivedAt": null,
  "owner": "/users/{id}",
  "jobTitle": null,
  "tags": [
    "/tags/{id}"
  ],
  "segments": [
    "/segments/{id}"
  ],
  "organizations": [
    "/organizations/{id}"
  ],
  "emailAddresses": [
    {
      "email": null
    }
  ],
  "phoneNumbers": [
    {
      "phoneNumber": null,
      "phoneType": "fax"
    }
  ],
  "address": {
    "city": null,
    "postalCode": null,
    "street": null,
    "country": "NL"
  },
  "avatarUrl": null,
  "dealSize": null,
  "totalDeals": null,
  "totalLostDeals": null,
  "totalWonDeals": null,
  "linkedinEnrichment": [
    null
  ],
  "id": null
}

List person notes

get

Returns all notes attached to a given person, ordered by flag and creation date.

Authorizations

Path parameters

personIdstringRequired

PersonNoteResource identifier

Query parameters

pageintegerOptional

The collection page number

Default: 1

itemsPerPageinteger · max: 30Optional

The number of items per page

Default: 15

qstringOptional

personstringOptional

person[]string[]Optional

category.idstringOptional

category.id[]string[]Optional

author.idstringOptional

author.id[]string[]Optional

flaggedbooleanOptional

order[flagged]string · enumOptionalPossible values:

order[createdAt]string · enumOptionalPossible values:

createdAt[strictly_after]stringOptional

createdAt[after]stringOptional

createdAt[strictly_before]stringOptional

createdAt[before]stringOptional

Responses

200

PersonNoteResource collection

403

Forbidden

get

/people/{personId}/notes

GET /people/{personId}/notes HTTP/1.1
Host: api.rogerroger.io
Accept: */*

{
  "member": [
    {
      "@context": "text",
      "@id": "text",
      "@type": "text",
      "id": null,
      "createdAt": null,
      "description": null,
      "title": null,
      "flagged": null,
      "isPrivate": null,
      "author": "/users/{id}",
      "category": "/note_categories/{id}"
    }
  ],
  "totalItems": 1,
  "view": {
    "@id": "string",
    "type": "string",
    "first": "string",
    "last": "string",
    "previous": "string",
    "next": "string"
  },
  "search": {
    "@type": "text",
    "template": "text",
    "variableRepresentation": "text",
    "mapping": [
      {
        "@type": "text",
        "variable": "text",
        "property": null,
        "required": true
      }
    ]
  }
}

Get person note

get

Retrieves a single note attached to a person.

Authorizations

Path parameters

personIdstringRequired

PersonNoteResource identifier

idstringRequired

PersonNoteResource identifier

Responses

200

PersonNoteResource resource

403

Forbidden

404

Not found

get

/people/{personId}/notes/{id}

GET /people/{personId}/notes/{id} HTTP/1.1
Host: api.rogerroger.io
Accept: */*

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "createdAt": null,
  "description": null,
  "title": null,
  "flagged": null,
  "isPrivate": null,
  "author": "/users/{id}",
  "category": "/note_categories/{id}"
}

Create person note

post

Creates a new note linked to a specific person.

Authorizations

Path parameters

personIdstringRequired

PersonNoteResource identifier

Body

Represents a CRM note attached to a person, such as contact moments or meeting summaries.

idstring | nullOptional

personIdstring | nullWrite-onlyOptional

createdAtstring | nullOptional

descriptionstring | nullRequired

titlestring | nullOptional

flaggedboolean | nullOptional

isPrivateboolean | nullOptional

authorstring | nullOptionalExample: /users/{id}

categorystring | nullRequiredExample: /note_categories/{id}

Responses

201

PersonNoteResource resource created

400

Invalid input

403

Forbidden

422

An error occurred

post

/people/{personId}/notes

POST /people/{personId}/notes HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/ld+json
Accept: */*
Content-Length: 166

{
  "id": null,
  "personId": null,
  "createdAt": null,
  "description": null,
  "title": null,
  "flagged": null,
  "isPrivate": null,
  "author": "/users/{id}",
  "category": "/note_categories/{id}"
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "createdAt": null,
  "description": null,
  "title": null,
  "flagged": null,
  "isPrivate": null,
  "author": "/users/{id}",
  "category": "/note_categories/{id}"
}

Replace person note

put

Replaces all fields of a person note.

Authorizations

Path parameters

personIdstringRequired

PersonNoteResource identifier

idstringRequired

PersonNoteResource identifier

Body

Represents a CRM note attached to a person, such as contact moments or meeting summaries.

idstring | nullOptional

personIdstring | nullWrite-onlyOptional

createdAtstring | nullOptional

descriptionstring | nullRequired

titlestring | nullOptional

flaggedboolean | nullOptional

isPrivateboolean | nullOptional

authorstring | nullOptionalExample: /users/{id}

categorystring | nullRequiredExample: /note_categories/{id}

Responses

200

PersonNoteResource resource updated

400

Invalid input

403

Forbidden

404

Not found

422

An error occurred

put

/people/{personId}/notes/{id}

PUT /people/{personId}/notes/{id} HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/ld+json
Accept: */*
Content-Length: 166

{
  "id": null,
  "personId": null,
  "createdAt": null,
  "description": null,
  "title": null,
  "flagged": null,
  "isPrivate": null,
  "author": "/users/{id}",
  "category": "/note_categories/{id}"
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "createdAt": null,
  "description": null,
  "title": null,
  "flagged": null,
  "isPrivate": null,
  "author": "/users/{id}",
  "category": "/note_categories/{id}"
}

Update person note

patch

Updates one or more fields of a person note.

Authorizations

Path parameters

personIdstringRequired

PersonNoteResource identifier

idstringRequired

PersonNoteResource identifier

Body

idstring | nullOptional

personIdstring | nullWrite-onlyOptional

createdAtstring | nullOptional

descriptionstring | nullOptional

titlestring | nullOptional

flaggedboolean | nullOptional

isPrivateboolean | nullOptional

authorstring | nullOptionalExample: /users/{id}

categorystring | nullOptionalExample: /note_categories/{id}

Responses

200

PersonNoteResource resource updated

400

Invalid input

403

Forbidden

404

Not found

422

An error occurred

patch

/people/{personId}/notes/{id}

PATCH /people/{personId}/notes/{id} HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/merge-patch+json
Accept: */*
Content-Length: 166

{
  "id": null,
  "personId": null,
  "createdAt": null,
  "description": null,
  "title": null,
  "flagged": null,
  "isPrivate": null,
  "author": "/users/{id}",
  "category": "/note_categories/{id}"
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "createdAt": null,
  "description": null,
  "title": null,
  "flagged": null,
  "isPrivate": null,
  "author": "/users/{id}",
  "category": "/note_categories/{id}"
}

PreviousPagination NextOrganizations

Last updated 7 months ago

hashtagCreate a new person

hashtagList people

hashtagRetrieve a person

hashtagUpdate a person

hashtagPartially update a person

hashtagList person notes

hashtagGet person note

hashtagCreate person note

hashtagReplace person note

hashtagUpdate person note

Create a new person

List people

Retrieve a person

Update a person

Partially update a person

List person notes

Get person note

Create person note

Replace person note

Update person note