Create Allocation

Creates a new allocation in Float.

POST

Query

Field selectionChoose which fields should be included in the response. Learn more

string

Comma-separated response fields to include.

Body

Arguments

numberrequired

The ID of the project for this allocation

number

The ID of the project phase for this allocation

stringrequired

Start date of this allocation

stringrequired

End date of this allocation

string

Start time in 24 hour format

numberrequired

Number of hours per day

number

The ID of the person assigned to the allocation

number

List of one or more people IDs assigned to the allocation

number

Status of the allocation

string

Name of the associated project task

number

The ID of the associated project task

string

Additional details about the work required

number

Frequency that this allocation repeats

string

Date that the repeating allocation will cease

Try this request

Request

curl --request POST \
  --url "https://connect.mindcloud.co/v1/universal/float/latest/actions/create-allocation" \
  --header "Authorization: Bearer $MINDCLOUD_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "connectionId": "$CONNECTION_ID",
  "startDate": "",
  "endDate": ""
}'

{
  "success": true,
  "data": [
    {
      "billable": 1,
      "created": "string",
      "createdBy": 1,
      "endDate": "string",
      "hours": 1,
      "modified": "string",
      "modifiedBy": 1,
      "name": "Ava Chen",
      "notes": {},
      "parentTaskId": {},
      "peopleId": 1,
      "phaseId": 1,
      "projectId": 1,
      "repeatEndDate": {},
      "repeatState": 1,
      "rootTaskId": {},
      "startDate": "string",
      "startTime": {},
      "status": 1,
      "taskId": 1,
      "taskMetaId": 1
    }
  ],
  "meta": {}
}

Every app you connect,one REST pattern

Call any app with one REST pattern. MindCloud handles each provider's auth, request shape, and responses for you.

Learn what the Universal API is

One REST patternUse the same request structure across apps like Slack, HubSpot, Salesforce, and thousands more.

Managed connectionsSend a MindCloud connection ID instead of handling provider tokens, refresh logic, and credential storage yourself.

Action-level docsEach action page shows the exact endpoint, required arguments, optional controls, and response behavior for that app version.