Overview

The Python client library is hosted on GitHub, and the package is available via PyPI.

Requirements

The library requires Python 3.7 or above. Note that compatibility with Python 2 was deprecated in version 4.0.0 of the library. For more information please see this blog post.

Prerequisites

Before installing the library, you will need a developer token and client customer ID. Instructions on how to obtain them are outlined in the prerequisites section. Note that you will generate the other required OAuth2 tokens in later steps.

Installation

Follow the instructions in our installation documentation to install the library from PyPi and return to this page.

Configuration

Once you have installed the library you will need to set up a configuration for it. There are multiple ways to configure the library, which are described in our configuration documentation.

Authentication

Once you've chosen a configuration type you can proceed with generating the remaining OAuth2 tokens needed to make requests to the API. There are multiple supported OAuth2 flows, which are documented in the list below. For details on the differences between the flows and help deciding which is best for your application, see our OAuth documentation.

Making an API request

Once you've incorporated your OAuth2 tokens into your configuration, you're ready to make an API request. Refer to the get campaigns example for a simple way to test that the library is properly configured to make API requests.

Additional resources

After you're able to make an API request, proceed to these uses of the client library: