Earthscale integration

Cecil integrates directly with Earthscale. Once connected, you can manage and visualise your Cecil data in the Earthscale user interface. This document describes the process to authorise Earthscale to access your Cecil account and clarifies responsibility in the billing process.

Create user

Use the Cecil SDK to create an Earthscale user in your Cecil account.

import cecil

client = cecil.Client()

client.create_user(
    first_name="Earthscale",
    last_name="Integration",
    email="engineering+earthscale@your-organisation.com",
)

You can use a different name and email. We recommend using a shared team email address such as engineering@your-organisation.com with the +earthscale suffix to the email username. This allows your engineering team to share access to the Earthscale integration while providing separation of concerns in your team’s email inbox with the +earthscale suffix.

Generate API key

Once you create an Earthscale user, follow the email instructions to generate a Cecil API key. Please do not store the Cecil API key anywhere else other than the Earthscale configuration in the next step. If needed, you can always rotate or recover Cecil API keys.

Authorise Earthscale

Follow the Earthscale documentation to configure your Cecil API key and learn more about working with your Cecil data in the Earthscale user interface.

By following this step, you are granting Earthscale full access to your Cecil account.

Billing process

In the future, you will be able to create Cecil subscriptions via Earthscale. When you use Earthscale to create Cecil subscriptions, the billing process will be managed by Cecil. You will also be able to use the Cecil SDK to list and identify which records were created via Earthscale.

Support

If you need assistance setting up the integration, please contact support@cecil.earth.