FOfolk
Companies

Create companies in batch

Changed on

Create up to 100 companies in the workspace. A record naming an existing company updates that company, as POST /v1/companies does, and its result says so. Each record is processed on its own: one that fails does not prevent the others from being created.

post/v1/companies/batch/create

Request

  • Base URL
    https://api.folk.app
  • URL
    https://api.folk.app/v1/companies/batch/create
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

A unique key, such as a UUID, that makes retrying this request safe: a retry with the same key and body returns the original response without running the operation again. Keys are kept for 24 hours after the request completes.

Example:8e03978e-40d5-43e8-bc93-6894a57f9324

Request body

Example request

{
  "records": [
    {
      "name": "Tech Corp",
      "industry": "Software",
      "emails": [
        "contact@techcorp.com"
      ],
      "urls": [
        "https://techcorp.com"
      ],
      "groups": [
        {
          "id": "grp_5fa60242-0756-4e31-8cca-30c2c5ff1ac2"
        }
      ]
    }
  ]
}

Response

The outcome of each record, with each created or updated company.

deprecationsstring[]

Example response

{
  "data": {
    "results": [
      {
        "status": "succeeded",
        "data": {
          "id": "com_183ed5cc-3182-45de-84d1-d520f2604810",
          "name": "Tech Corp",
          "description": "A leading technology company.",
          "fundingRaised": "5000000",
          "lastFundingDate": "1990-01-01",
          "industry": "Technology",
          "foundationYear": "1990",
          "employeeRange": "51-200",
          "groups": [
            {
              "id": "grp_5fa60242-0756-4e31-8cca-30c2c5ff1ac2",
              "name": "Engineering"
            }
          ],
          "addresses": [
            "123 Main St, Springfield, USA",
            "456 Main St, Springfield, USA"
          ],
          "emails": [
            "john@example.com",
            "john@techcorp.com"
          ],
          "phones": [
            "+1234567890",
            "+0987654321"
          ],
          "urls": [
            "https://example.com"
          ],
          "createdAt": "2021-01-01T00:00:00.000Z",
          "createdBy": {
            "id": "usr_bc984b3f-0386-434d-82d7-a91eb6badd71",
            "fullName": "John Doe",
            "email": "john.doe@example.com"
          },
          "customFieldValues": {
            "grp_5fa60242-0756-4e31-8cca-30c2c5ff1ac2": {
              "Status": "Active",
              "Business type": [
                "B2B",
                "B2C"
              ],
              "Join date": "2021-01-01",
              "Relationships": [
                {
                  "id": "per_ed110a47-5d09-43bf-b2e2-791d8231eb5f",
                  "fullName": "Bob Smith",
                  "entityType": "person"
                },
                {
                  "id": "com_9a03f575-8a85-40b0-ba2e-16d8e29e3b03",
                  "fullName": "HR services",
                  "entityType": "company"
                }
              ]
            },
            "grp_acdf2ad9-6a66-4d32-8594-9694913ac717": {
              "Custom Notes": "Important client, handle with care.",
              "ARR": "42000000",
              "Assignee": [
                {
                  "id": "usr_c3606e3b-0a92-4849-90e5-88a8d3f388d6",
                  "fullName": "Jane Doe",
                  "email": "jane@example.com"
                }
              ]
            }
          }
        },
        "operation": "created"
      },
      {
        "status": "failed",
        "error": {
          "code": "NOT_FOUND",
          "message": "Not found.",
          "documentationUrl": "https://developer.folk.app/api-reference/errors#not-found"
        }
      }
    ]
  },
  "deprecations": [
    "This field is deprecated"
  ]
}

Changes