OKF example bundle

API Reference OKF Bundle

Endpoint documentation with request, response, auth, and failure cases.

Developer docs and API support agents.

index.mdAPI Reference

description: Navigation for API endpoint documentation.

create-customer.mdCreate customer

description: Creates a customer record and returns the created customer ID.

Bundle Markdown

<!-- index.md -->
---
type: index
title: API Reference
description: Navigation for API endpoint documentation.
tags:
  - api
timestamp: 2026-06-27
---

# API Reference

- [Create customer](create-customer.md)

<!-- create-customer.md -->
---
type: api-endpoint
title: Create Customer
description: Creates a customer record and returns the created customer ID.
resource: https://api.example.com/docs/customers#create
tags:
  - api
  - customers
timestamp: 2026-06-27
---

# Create Customer

## Purpose
Use this endpoint when an agent needs to create a new customer after collecting required profile fields.

## Request
- Method: POST
- Path: /v1/customers
- Required fields: name, email

## Response
Returns the created customer ID, status, and timestamps.

## Failure Cases
- 400 when required fields are missing.
- 409 when the email already exists.