Affiliations
The following macros are not currently supported in the header:
  • style

Affiliations

 

Introduction

An affiliation connects a contact to a company. A contact and company can have multiple affiliations. i.e, a contact has a many-to-many relationship company-  affiliation maps this relationship.

Endpoints

 

METHOD

ENDPOINT

DESCRIPTION

METHOD

ENDPOINT

DESCRIPTION

GET

affiliations

Returns a list of Affiliations..

GET

affiliations/count

Returns the total number of affiliations.

GET

affiliations/newest

Returns a list of affiliations ordered by date_modified descending

GET

affiliations/:id

Returns an affiliation identified by its id.

GET

affiliations/:id/status

Returns an affiliation's status

DELETE

affiliations/:id

Removes an affiliation identified by its id.

POST

affiliations 

Creates a new affiliation.

PUT

affiliations/:id

Updates an affiliation identified by its id.

GET

/affiliations/:id/profiles/values

Returns an array of profile values for the affiliation

PUT

/affiliations/:id/profiles/values/:profile_value_id

Update an existing profile value for the affiliation

GET

/affiliations/:id/progressions

Returns an array of available progressions for the affiliation.

[PUT|POST]

/affiliations/:id/progressions/:progression_id/auto

Runs a status update for the given progression on the given affiliation.

GET

/affiliations/profiles/fields

Returns an array of profile fields for affiliation.

POST

/affiliations/:affiliation_id/profiles/fields/:profile_field_id

Creates a profile value for an affiliation.

Filters

These values can be used to filter through lists of affiliations. You can define filters in the _filters parameter.

standing

Array of standing status strings. For example standing(inactive,active)- filter out affiliation that do not have the supplied standing.

mobile

Only return affiliations matching the supplied mobile number(s).

fax

Only return affiliations matching the supplied fax number(s).

phone

Only return affiliations matching the supplied phone number(s).

contact_number

Only return affiliations having a mobile, phone or fax matching one of the supplied phone numbers.

NEW

order_by_asc(<type>), order_by_desc(<type>)

 

Accepts: fullname, status, standing, date_modified and date_last_interacted

NEW

<field_name>_greater_than(<value>),

<field_name>_less_than(<value>),

<field_name>_greater_than_or_equal(<value>),

<field_name>_less_than_or_equal(<value>)

Available fields:

id
country
physical_address
postal_address
contact
status



NOTE: filters will ignore whitespace and are generally whitelists.

Using the _not suffix (e.g, id_not) on standard in filters will returns results not in.