Reportei

Use Reportei via direct curl calls to generate and manage marketing reports with automated analytics.

Official docs: https://app.reportei.com/docs/api

When to Use

Use this skill when you need to:

Retrieve company and template information
List and manage client projects
Generate and access marketing reports
Manage integrations (Google Analytics, Meta, etc.)
Set up webhooks for automated notifications

Prerequisites

Sign up at Reportei
Go to Dashboard → Generate API Token
Copy your API token

export REPORTEI_API_TOKEN="your-api-token"

Base URL

https://app.reportei.com/api/v1

Important: When using $VAR in a command that pipes to another command, wrap the command containing $VAR in bash -c '...'. Due to a Claude Code bug, environment variables are silently cleared when pipes are used directly.
bash -c 'curl -s "https://api.example.com" -H "Authorization: Bearer $API_KEY"' | jq .

How to Use

1. Get Company Details

Retrieve details of your company associated with the token:

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/me" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq .

Response:

{
  "company": {
  "id": 1,
  "name": "Your Company",
  "logo": "logo.jpeg",
  "type": "agency",
  "potential_clients": "11-15",
  "company_specialty": "paid traffic"
  }
}

2. List Templates

Retrieve all report templates in your company:

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/templates" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq '.data[] | {id, title, used_count}

3. List Clients (Projects)

Retrieve all client projects:

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/clients" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq .

4. Get Client Details

Retrieve details of a specific client:

CLIENT_ID="your-client-id"

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/clients/${CLIENT_ID}" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq .

5. List Client Reports

Get all reports for a specific client:

CLIENT_ID="your-client-id"

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/clients/${CLIENT_ID}/reports" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq .

6. Get Report Details

Retrieve details of a specific report:

REPORT_ID="your-report-id"

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/reports/${REPORT_ID}" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq .

7. List Client Integrations

Get all integrations for a specific client:

CLIENT_ID="your-client-id"

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/clients/${CLIENT_ID}/integrations" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq .

8. Get Integration Details

Retrieve details of a specific integration:

INTEGRATION_ID="your-integration-id"

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/integrations/${INTEGRATION_ID}" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq .

9. Get Integration Widgets

List available widgets for an integration:

INTEGRATION_ID="your-integration-id"

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/integrations/${INTEGRATION_ID}/widgets" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq .

10. Get Widget Value

Retrieve the value of specific widgets:

INTEGRATION_ID="your-integration-id"

bash -c 'curl -s -X POST "https://app.reportei.com/api/v1/integrations/${INTEGRATION_ID}/widgets/value" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}" -H "Content-Type: application/json" -d '"'"'{
  "widgets": ["widget_id_1", "widget_id_2"],
  "start_date": "2024-01-01",
  "end_date": "2024-01-31"
  }'"'"' | jq .'

11. Create Report (Connector Action)

Create a new report programmatically:

bash -c 'curl -s -X POST "https://app.reportei.com/api/v1/create_report" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}" -H "Content-Type: application/json" -d '"'"'{
  "client_id": "your-client-id",
  "template_id": "your-template-id",
  "start_date": "2024-01-01",
  "end_date": "2024-01-31"
  }'"'"' | jq .'

12. Create Dashboard (Connector Action)

Create a new dashboard:

bash -c 'curl -s -X POST "https://app.reportei.com/api/v1/create_dashboard" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}" -H "Content-Type: application/json" -d '"'"'{
  "client_id": "your-client-id",
  "name": "My Dashboard"
  }'"'"' | jq .'

13. Add to Timeline (Connector Action)

Add an entry to the client timeline:

bash -c 'curl -s -X POST "https://app.reportei.com/api/v1/add_to_timeline" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}" -H "Content-Type: application/json" -d '"'"'{
  "client_id": "your-client-id",
  "title": "Campaign Launched",
  "description": "New marketing campaign started"
  }'"'"' | jq .'

14. List Webhook Events

Get available webhook event types:

bash -c 'curl -s -X GET "https://app.reportei.com/api/v1/webhook/events" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}"' | jq .

15. Subscribe to Webhook

Subscribe to webhook notifications:

bash -c 'curl -s -X POST "https://app.reportei.com/api/v1/webhooks/subscribe" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}" -H "Content-Type: application/json" -d '"'"'{
  "url": "https://your-webhook-endpoint.com/webhook",
  "events": ["report.created", "report.updated"]
  }'"'"' | jq .'

16. Unsubscribe from Webhook

Unsubscribe from webhook notifications:

bash -c 'curl -s -X POST "https://app.reportei.com/api/v1/webhooks/unsubscribe" -H "Authorization: Bearer ${REPORTEI_API_TOKEN}" -H "Content-Type: application/json" -d '"'"'{
  "webhook_id": "your-webhook-id"
  }'"'"' | jq .'

Company Types

Type	Description
`agency`	Marketing agency
`freelancer`	Independent professional
`company`	In-house marketing team

Response Fields

Company Object

Field	Description
`id`	Company unique identifier
`name`	Company name
`logo`	Logo filename
`type`	Company type
`potential_clients`	Client range
`company_specialty`	Main focus area

Template Object

Field	Description
`id`	Template unique identifier
`title`	Template name
`description`	Template description
`used_count`	Times template has been used
`created_at`	Creation timestamp
`updated_at`	Last update timestamp

Guidelines

Bearer Token: Always include the Authorization header with Bearer token
Rate Limits: Be mindful of API rate limits
Date Format: Use ISO format (YYYY-MM-DD) for date parameters
Client IDs: Get client IDs from the /clients endpoint first
Template IDs: Get template IDs from the /templates endpoint
Webhooks: Use webhooks for real-time notifications instead of polling
Dashboard: Use https://app.reportei.com for visual report management

reportei