Create Service Account

1️⃣ Overview

Purpose:
Creates a new service account within a specific company.

A unique system-generated email (e.g., @datagol.iam.serviceaccount.com) is assigned to the account upon creation.

---

2️⃣ Endpoint

POST /idp/api/v1/company/serviceAccount

Base URL:

https://be.datagol.ai

---

3️⃣ Authentication

Requires Bearer Token
User must have ACCOUNT_ADMIN or similar administrative privileges.

---

4️⃣ Request Headers

Header	Required
Authorization: Bearer	✅ Yes
Content-Type: application/json	✅ Yes

---

5️⃣ Request Body Schema

{
  "name": "string",
  "description": "string"
}

---

6️⃣ Field Descriptions

Service Account Fields

Field	Type	Required	Description
name	string	✅ Yes	The unique identifier or display name for the service account with no spaces or special characters.
description	string	❌ No	A brief explanation of the account’s purpose (can be an empty string).

---

7️⃣ Example Request

curl -X POST https://be.datagol.ai/idp/api/v1/company/serviceAccount \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
  "name": "ci_cd_service_account",
  "description": "Service account for CI/CD integrations"
}'

---

8️⃣ Behavior Summary

Creates a new service account within the company and assigns a unique system-generated email address to it.