
Affinity API Integration Profile
Information and guides about integrating with Affinity API
Add Affinity Integration to Your App- Get current user
Returns metadata about the current user.
- Get all Companies
Paginate through Companies in Affinity. Returns basic information and non-list-specific field data on each Company.
To retrieve field data, you must use either the
fieldIds
or thefieldTypes
parameter to specify the Fields for which you want data returned. These Field IDs and Types can be found using the GET/v2/companies/fields
endpoint. When nofieldIds
orfieldTypes
are provided, Companies will be returned without any field data attached. To supply multiplefieldIds
orfieldTypes
parameters, generate a query string that looks like this:?fieldIds=field-1234&fieldIds=affinity-data-location
or?fieldTypes=enriched&fieldTypes=global
.Requires the "Export All Organizations directory" permission.
- Get a single Company
Returns basic information and non-list-specific field data on the requested Company.
To retrieve field data, you must use either the
fieldIds
or thefieldTypes
parameter to specify the Fields for which you want data returned. These Field IDs and Types can be found using the GET/v2/companies/fields
endpoint. When nofieldIds
orfieldTypes
are provided, Companies will be returned without any field data attached. To supply multiplefieldIds
orfieldTypes
parameters, generate a query string that looks like this:?fieldIds=field-1234&fieldIds=affinity-data-location
or?fieldTypes=enriched&fieldTypes=global
.Requires the "Export All Organizations directory" permission.
- Get metadata on Company Fields
Returns metadata on non-list-specific Company Fields.
Use the returned Field IDs to request field data from the GET
/v2/companies
and GET/v2/companies/{id}
endpoints. - Get a Company's Lists
Returns metadata for all the Lists on which the given Company appears.
- Get a Company's List Entries
Paginate through the List Entries (AKA rows) for the given Company across all Lists. Each List Entry includes field data for the Company, including list-specific field data. Each List Entry also includes metadata about its creation, i.e., when it was added to the List and by whom.
Requires the "Export data from Lists" permission.
- Get metadata on all Lists
Returns metadata on Lists.
- Get metadata on a single List
Returns metadata on a single List.
- Get all List Entries on a List
Paginate through the List Entries (AKA rows) on a given List. Returns basic information and field data, including list-specific field data, on each Company, Person, or Opportunity on the List. List Entries also include metadata about their creation, i.e., when they were added to the List and by whom.
To retrieve field data, you must use either the
fieldIds
or thefieldTypes
parameter to specify the Fields for which you want data returned. These Field IDs and Types can be found using the GET/v2/lists/{listId}/fields
endpoint. When nofieldIds
orfieldTypes
are provided, List Entries will be returned without any field data attached. To supply multiplefieldIds
orfieldTypes
parameters, generate a query string that looks like this:?fieldIds=field-1234&fieldIds=affinity-data-location
or?fieldTypes=enriched&fieldTypes=global
.Requires the "Export data from Lists" permission.
- Get metadata on a single List's Fields
Returns metadata on the Fields available on a single List.
Use the returned Field IDs to request field data from the GET
/v2/lists/{listId}/list-entries
endpoint.