Prime Group — Developers

Prime Group Developers

Connect your product to Prime Group execution

Add request intake, document uploads, workflow events, and status sync into your own product without rebuilding the operational layer from zero.

Read Docs Get API Key Talk to Technical Team

RESTRequests API

EventsWebhook Layer

SandboxTest Environment

JSONStructured Payloads

request architecture

Embedded intakeSubmit structured request data from your own UI.

UploadsAttach supporting files and document context.

Status syncMirror progress back into your product.

Webhook eventsTrigger CRM, ops, support, and notifications.

Client trackingKeep users informed without email friction.

Prime Group API Surface

One operating layer

Requests, files, workflow states, and event delivery in one clean developer flow.

request.createdNew request enters Prime Group

request.needs_inputAdditional files or details required

request.completedWorkflow reaches final completion

Use cases

What developers actually build here

Less brochure. More concrete integration surface.

Use case 01

Submit requests directly from your product

Users stay inside your experience while you pass service type, notes, files, and client context into Prime Group.

Embedded forms Validation Uploads

Use case 02

Mirror request progress in your own dashboard

Show submitted, in review, needs input, and completed states without forcing users into email-based tracking.

Status API Polling Timeline Sync

Use case 03

Trigger workflow actions when events land

Push changes into CRM records, support queues, onboarding flows, or client messaging the moment state changes.

Webhooks CRM Automation

Integration flow

Simple integration flow

One lane from request creation to completion.

Create credentials

Use sandbox keys first and keep test and live isolated.

Create request

Send service type, client data, notes, and request metadata.

Receive updates

Listen for events or fetch the latest state when needed.

Display progress

Surface status, missing input, and completion in your own UI.

Sandbox first

Structured payloads

Status visibility

Event-driven sync

Core endpoints

API surface

Keep it obvious.

POST

/v1/requests

create

GET

/v1/requests/{id}

status

POST

/v1/uploads

files

POST

/v1/webhooks/test

events

Practical notes

What developers look for

No filler section.

Authentication Bearer keys for sandbox and production environments.

Signature verification Verify webhook deliveries before processing events.

Rate limits Predictable throttling with retry-safe request behavior.

Versioning Stable endpoint behavior with explicit API evolution.

Quickstart

Make the first request

Start in sandbox, validate request creation, then wire status sync and webhook handling before enabling live traffic.

Sandbox First Bearer Auth JSON Payload Webhook Ready

Environment

Sandbox

Use your test key in the Authorization header. Sandbox requests never touch live workflows.

Step 01 Authorize every request Pass your API key in the Authorization header for all server-side calls.

Step 02 Send structured payloads Include service type, client details, notes, and priority in one clean body.

Step 03 Handle response + state Store the request ID, display the returned state, and subscribe to updates.

create-request.sh
POST/v1/requestsapplication/json
curl --request POST "https://api.primegroupone.com/v1/requests" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "service_type": "kyb-document-preparation",
    "environment": "sandbox",
    "client": {
      "name": "Northline Studio LLC",
      "email": "ops@northline.example",
      "external_id": "acct_29481"
    },
    "request": {
      "title": "KYB packet for processor onboarding",
      "notes": "Need a submission-ready document set.",
      "priority": "standard",
      "source": "partner_dashboard"
    },
    "metadata": {
      "workspace": "northline-partner-app",
      "requested_by": "operations",
      "locale": "en-US"
    }
  }'

create-request.js
Fetch APIAsyncJSON
const payload = {
  service_type: "kyb-document-preparation",
  environment: "sandbox",
  client: {
    name: "Northline Studio LLC",
    email: "ops@northline.example",
    external_id: "acct_29481"
  },
  request: {
    title: "KYB packet for processor onboarding",
    notes: "Need a submission-ready document set.",
    priority: "standard",
    source: "partner_dashboard"
  },
  metadata: {
    workspace: "northline-partner-app",
    requested_by: "operations",
    locale: "en-US"
  }
};

const response = await fetch(
  "https://api.primegroupone.com/v1/requests",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.PRIME_GROUP_API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(payload)
  }
);

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const data = await response.json();
console.log("request_id:", data.id);
console.log("status:", data.status);
console.log("next_action:", data.next_action);

create_request.py
RequestsServer-sideJSON
import os
import requests

payload = {
    "service_type": "kyb-document-preparation",
    "environment": "sandbox",
    "client": {
        "name": "Northline Studio LLC",
        "email": "ops@northline.example",
        "external_id": "acct_29481",
    },
    "request": {
        "title": "KYB packet for processor onboarding",
        "notes": "Need a submission-ready document set.",
        "priority": "standard",
        "source": "partner_dashboard",
    },
    "metadata": {
        "workspace": "northline-partner-app",
        "requested_by": "operations",
        "locale": "en-US",
    },
}

response = requests.post(
    "https://api.primegroupone.com/v1/requests",
    headers={
        "Authorization": f"Bearer {os.environ['PRIME_GROUP_API_KEY']}",
        "Content-Type": "application/json",
    },
    json=payload,
    timeout=30,
)

response.raise_for_status()
data = response.json()

print("request_id:", data.get("id"))
print("status:", data.get("status"))
print("next_action:", data.get("next_action"))