Search

Search for emails using specified criteria and filters.

Changed on

Perform a search for emails based on the provided query parameters and return matching results.

post/crm/objects/2026-03/emails/search

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/objects/2026-03/emails/search
  • Auth
    none required

Request body

afterstring required

A paging cursor token for retrieving subsequent pages.

limitinteger required

The maximum results to return, up to 200 objects.

propertiesstring[] required

A list of property names to include in the response.

querystring

The search query string, up to 3000 characters.

sortsstring[] required

Specifies sorting order based on object properties.

Response

successful operation

totalinteger required

The number of available results

Changes

  • 2026-030e24e10a5e31Revision changes
    • info

      the endpoint scheme security oauth2 was removed from the API

    • info

      the endpoint scheme security oauth2 was removed from the API

  • 2026-03766403532217Revision changes
    • info

      the security scope crm.objects.contacts.read was added to the endpoint's security scheme oauth2

    • info

      the security scope sales-email-read was removed from the endpoint's security scheme oauth2