Python Library to Manage Contacts via the HubSpot API
Sponsored by:2degrees Limited.

hubspot-contacts is a high-level, Pythonic wrapper for HubSpot API methods in the Contacts, Contact Lists and Contact Properties APIs.

Here’s an example of how it can be used:

>>> from hubspot.connection import APIKey, PortalConnection
>>> from hubspot.contacts import Contact
>>> from hubspot.contacts.lists import get_all_contacts
>>> authentication_key = APIKey("your key")
>>> with PortalConnection(authentication_key, "Your App Name") as connection:
...     for contact in get_all_contacts(connection):
...         print contact
Contact(vid=1, email_address=u'', properties={u'lastname': u'Smith', u'company': u'ACME Ltd.', u'firstname': u'John', u'lastmodifieddate': datetime.datetime(2014, 5, 30, 15, 32, 7, 192000)}, related_contact_vids=[])
Contact(vid=2, email_address=u'', properties={u'lastname': u'Doe', u'company': u'Example Inc.', u'firstname': u'Alice', u'lastmodifieddate': datetime.datetime(2014, 5, 29, 15, 37, 52, 447000)}, related_contact_vids=[])

This project is officially supported under Python 2.7, but may work with Python 2.6 and Python 3.

hubspot-contacts depends on hubspot-connection, a separate library that abstracts the low-level communication with HubSpot and takes care of authentication, among other things.

To get started, find the functions you need in the API Documentation and then read Testing Tutorial.

Table Of Contents

Next topic

API Documentation

This Page