Quickstart

This guide walks you through setting up your Cohera account, generating API credentials, and making your first API call.

Account Setup

1. Sign up for Cohera

   Visit cohera.io/signup to create your account. Enterprise customers should contact their account manager for SSO setup.

2. Complete onboarding

   After email verification, complete the onboarding wizard to configure your organization settings, including:

   • Organization name and industry
   • Primary use case (certificate management, supplier qualification, etc.)
   • Compliance requirements (FDA, EMA, or both)

3. Invite team members

   Navigate to Settings > Team to invite colleagues. Assign roles based on their responsibilities:

   • Admin: Full platform access
   • Developer: API access and integration management
   • Analyst: Read-only access to dashboards and reports
   • Auditor: Access to audit logs and compliance reports

API Key Generation

1. Navigate to Settings > API Keys in the Cohera dashboard

2. Click Create API Key

3. Configure the key:

   • Name: A descriptive name (e.g., “Production Integration”)
   • Environment: Production or Sandbox
   • Permissions: Select the scopes required
   • Expiration: Set an expiration date (recommended: 90 days for production)

4. Copy the API key immediately. It will not be shown again.

Security Notice

Store your API key securely. Never commit it to version control or expose it in client-side code. Use environment variables or a secrets manager.

Your First API Call

Let’s verify your setup by listing entities in your organization.

curl

curl -X GET "https://api.cohera.io/v1/entities" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Python

import requests

api_key = "YOUR_API_KEY"
base_url = "https://api.cohera.io/v1"

response = requests.get(
    f"{base_url}/entities",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
)

print(response.json())

TypeScript

const apiKey = process.env.COHERA_API_KEY;
const baseUrl = "https://api.cohera.io/v1";

const response = await fetch(`${baseUrl}/entities`, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
});

const data = await response.json();
console.log(data);

Expected Response

{
  "data": [],
  "meta": {
    "total": 0,
    "page": 1,
    "per_page": 25
  }
}

A new account will have an empty entity list. Let’s create your first entity.

Create Your First Entity

Create a supplier entity to start building your data model.

curl

curl -X POST "https://api.cohera.io/v1/entities" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "supplier",
    "name": "Acme Chemicals",
    "attributes": {
      "country": "DE",
      "qualification_status": "qualified",
      "primary_contact": "supplier@acme-chemicals.de"
    }
  }'

Python

import requests

api_key = "YOUR_API_KEY"
base_url = "https://api.cohera.io/v1"

payload = {
    "type": "supplier",
    "name": "Acme Chemicals",
    "attributes": {
        "country": "DE",
        "qualification_status": "qualified",
        "primary_contact": "supplier@acme-chemicals.de"
    }
}

response = requests.post(
    f"{base_url}/entities",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json=payload
)

print(response.json())

TypeScript

const apiKey = process.env.COHERA_API_KEY;
const baseUrl = "https://api.cohera.io/v1";

const payload = {
  type: "supplier",
  name: "Acme Chemicals",
  attributes: {
    country: "DE",
    qualification_status: "qualified",
    primary_contact: "supplier@acme-chemicals.de",
  },
};

const response = await fetch(`${baseUrl}/entities`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});

const data = await response.json();
console.log(data);

Expected Response

{
  "data": {
    "id": "ent_abc123def456",
    "type": "supplier",
    "name": "Acme Chemicals",
    "attributes": {
      "country": "DE",
      "qualification_status": "qualified",
      "primary_contact": "supplier@acme-chemicals.de"
    },
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z",
    "created_by": "user_xyz789"
  }
}

Next Steps

You’ve successfully set up your Cohera account and made your first API calls. Continue exploring:

• Authentication - Learn about OAuth2 and JWT tokens
• Entities API - Full entity management documentation
• Certificates - Upload and manage compliance certificates
• Integrations - Connect to SAP, Veeva, and other systems

Using the Sandbox

The sandbox environment (sandbox.api.cohera.io) mirrors production but uses test data. Use it for:

• Development and testing
• Integration debugging
• Training new team members

Tip

Sandbox data is reset weekly. Do not use it for persistent storage.