Basecamp API

Contact Management API Calls

Companies

/contacts/companies

Returns a list of all companies visible to the given person. This is only accessible to employees of the "firm" (the company assoicated with the account). Client employees will get a 403 response if they attempt to access this method.

Response

<companies>
  <company>
    ...
  </company>
  ...
</companies>

Company

/contacts/company/#{company_id}

This will return the information for the referenced company.

Response

<company>
  ...
</company>

People

/contacts/people/#{company_id}

This will return all of the people in the given company. If a project id is given, it will be used to filter the set of people that are returned to include only those that can access the given project.

Response

<people>
  <person>
    ...
  </person>
  <person>
    ...
  </person>
  ...
</people>

People per project

/projects/#{project_id}/contacts/people/#{company_id}

This will return all of the people in the given company that can access the given project.

Response

<people>
  <person>
    ...
  </person>
  <person>
    ...
  </person>
  ...
</people>

Person

/contacts/person/#{person_id}

This will return information about the referenced person.

Response

<person>
  ...
</person>