Download the PHP package convertkit/convertkitapi without Composer

ConvertKit SDK PHP

The ConvertKit PHP SDK provides convinient access to the ConvertKit API from applications written in the PHP language.

It includes a pre-defined set of methods for interacting with the API.

Version Guidance

Refer to this guide for changes when upgrading to the v2 SDK.

Composer

You can install this PHP SDK via Composer. Run the following command:

To use the PHP SDK, use Composer's autoload:

Dependencies

The PHP SDK require the following extensions in order to work properly:

• curl, although you can use your own non-cURL client if you prefer
• json
• mbstring (Multibyte String)

If you use Composer, these dependencies should be handled automatically.

Getting Started

2.x (v4 API, OAuth, PHP 8.0+)

First, register your OAuth application in the OAuth Applications section at https://app.convertkit.com/account_settings/advanced_settings.

Using the supplied Client ID and secret, redirect the user to ConvertKit to grant your application access to their ConvertKit account.

Once the user grants your application access to their ConvertKit account, they'll be redirected to your Redirect URI with an authorization code. For example:

your-redirect-uri?code=<auth_code>

At this point, your application needs to exchange the authorization code for an access token and refresh token.

$result is an array comprising of:

• access_token: The access token, used to make authenticated requests to the API
• refresh_token: The refresh token, used to fetch a new access token once the current access token has expired
• created_at: When the access token was created
• expires_in: The number of seconds from created_at that the access token will expire

Once you have an access token, re-initialize the API class with it:

To refresh an access token:

$result is an array comprising of:

• access_token: The access token, used to make authenticated requests to the API
• refresh_token: The refresh token, used to fetch a new access token once the current access token has expired
• created_at: When the access token was created
• expires_in: The number of seconds from created_at that the access token will expire

Once you have refreshed the access token i.e. obtained a new access token, re-initialize the API class with it:

API requests may then be performed:

To determine whether a new entity / relationship was created, or an existing entity / relationship updated, inspect the HTTP code of the last request:

The PSR-7 response can be fetched and further inspected, if required - for example, to check if a header exists:

1.x (v3 API, API Key and Secret, PHP 7.4+)

Get your ConvertKit API Key and API Secret here and set it somewhere in your application.

Handling Errors

The ConvertKit PHP SDK uses Guzzle for all HTTP API requests. Errors will be thrown as Guzzle's ClientException (for 4xx errors), or ServerException (for 5xx errors).

For a more detailed error message, it's possible to fetch the API's response when a ClientException is thrown:

Documentation

See the PHP SDK docs

Contributing

See our contributor guide for setting up your development environment, testing and submitting a PR.

For ConvertKit, refer to the deployment guide on how to publish a new release.