Skip to main content
Create a new team. The caller is auto-added as an accepted admin member. Team scoring requires the Business plan or higher. 
curl -X POST https://app.dacard.ai/api/teams \
  -H "Authorization: Bearer $DACARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Product" }'
PropertyValue
AuthRequired
Required planBusiness or Enterprise
IdempotentNo (creates a new team on every call)

​
Body

FieldTypeRequiredNotes
namestringyesTrimmed. Empty strings rejected.

​
Response

201 Created 
{
  "team": {
    "id": "tm_2x1B3y...",
    "name": "Acme Product",
    "accountId": "acc_...",
    "createdBy": "user_...",
    "createdAt": "2026-05-06T18:11:43Z"
  }
}

​
Errors

StatusCodeWhen
400name is requiredBody missing or empty name.
401AUTH_REQUIREDNo session.
403FEATURE_GATEDCaller is on Free or Pro. Move up to Business.
500INTERNAL_ERRORWrite failed.

​
Side effects

  • Audit log entry: team_created.
  • PQL event: team_invite_sent with action: team_created.
  • Caller’s membership row inserted with role: admin, status: accepted.