Create object

POST/objects

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Query parameters

fieldsToReturnstring

Comma-separated list of top-level response fields to return. Overrides the endpoint compact default unless responseShape=full is used.

responseShapestring

Advanced override. Omit for the endpoint compact default. Use full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:compactfull

Header parameters

LT-Response-Shapestring

Advanced override. Set to full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:full

Request body

requiredapplication/json

customFieldsobject

Custom field values keyed by field id

externalIdobject | null

External system identifier

namestringrequired

Display name

objectTypeIdstringrequired

Object type UUID

organizationIdobject | null

Organization UUID; omit or null for internal object

projectIdobject | null

Assigned project UUID

statusIdstringrequired

Status UUID (must belong to the object type)

tagsstring[]

Responses

200

createdAtstringrequired

customFieldsobjectrequired

editedAtstringrequired

externalIdobject | nullrequired

idstringrequired

namestringrequired

objectTypeObjectTypeSummaryDtorequired

Show properties

iconobject | nullrequired

idstringrequired

namestringrequired

slugstring | nullrequired

organizationobject | nullrequired

Show properties

idstringrequired

namestringrequired

shortNamestringrequired

organizationIdobject | nullrequired

projectobject | nullrequired

Show properties

idstringrequired

namestringrequired

shortNumbernumberrequired

projectIdobject | nullrequired

statusObjectStatusSummaryDtorequired

Show properties

colorstringrequired

idstringrequired

namestringrequired

tagsstring[]required

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X POST "https://leadtime.app/api/public/objects" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "customFields": {},
  "externalId": {},
  "name": "string",
  "objectTypeId": "string",
  "organizationId": {},
  "projectId": {},
  "statusId": "string",
  "tags": [
    "string"
  ]
}'

const response = await fetch("https://leadtime.app/api/public/objects", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "customFields": {},
  "externalId": {},
  "name": "string",
  "objectTypeId": "string",
  "organizationId": {},
  "projectId": {},
  "statusId": "string",
  "tags": [
    "string"
  ]
})
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/objects",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "customFields": {},
  "externalId": {},
  "name": "string",
  "objectTypeId": "string",
  "organizationId": {},
  "projectId": {},
  "statusId": "string",
  "tags": [
    "string"
  ]
},
)

Response

{
  "createdAt": "string",
  "customFields": {},
  "editedAt": "string",
  "externalId": {},
  "id": "string",
  "name": "string",
  "objectType": {
    "icon": {},
    "id": "string",
    "name": "string",
    "slug": "string"
  },
  "organization": {
    "id": "string",
    "name": "string",
    "shortName": "string"
  },
  "organizationId": {},
  "project": {
    "id": "string",
    "name": "string",
    "shortNumber": 0
  },
  "projectId": {},
  "status": {
    "color": "string",
    "id": "string",
    "name": "string"
  },
  "tags": [
    "string"
  ]
}