Time entries

cURL Ruby

List all time entries

GET /time_entries(.:format)

Returns a paginated list of all time entries in the administration.

The filter argument allows you to filter the list of time entries. Filters are a combination of keys and values, separated by a comma: period:this_year,state:all. The available options for filtering are:

Filter Type Default Description
state String all all, open or non_billable
period String this_year This can either be the description of a period (this_month, prev_month, next_month, this_quarter, prev_quarter, next_quarter, this_year, prev_year, next_year) or a custom period (201301..201302, 20130101..20130131)
contact_id Integer   Select time entries belonging to a certain contact
include_nil_contacts Boolean false Whether to include time entries that have no assigned contact
project_id Integer   Select time entries belonging to a certain project
user_id Integer   Select time entries belonging to a certain user
day Date   Select time entries on a specific date

You can filter by multiple states at the same time as well. To do this, separate the state values by a pipe: state:open|non_billable.

Parameters

Parameter Type Description
filter String
query String

Allows filtering by time entry description.

Example: returns all time entries of an administration

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?

Response

        
          
          Status: 200 OK
        
      
      [
  {
    "id": "296678775343548174",
    "administration_id": 123,
    "contact_id": "296678775254419210",
    "project_id": "296678775285876492",
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T15:09:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2020-08-11T14:09:09.982Z",
    "updated_at": "2020-08-11T14:09:09.982Z",
    "contact": {
      "id": "296678775254419210",
      "firstname": "",
      "lastname": "",
      "company_name": "Foobar Holding B.V."
    },
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": {
      "id": "296678775285876492",
      "name": "My project name",
      "state": "active"
    },
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:09.994Z",
        "updated_at": "2020-08-11T14:09:09.994Z"
      }
    ],
    "notes": [

    ]
  },
  {
    "id": "296678775391782672",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T14:10:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2020-08-11T14:09:10.028Z",
    "updated_at": "2020-08-11T14:09:10.028Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:10.046Z",
        "updated_at": "2020-08-11T14:09:10.046Z"
      }
    ],
    "notes": [

    ]
  },
  {
    "id": "296678775441065746",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T14:10:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2020-08-11T14:09:10.074Z",
    "updated_at": "2020-08-11T14:09:10.074Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:10.088Z",
        "updated_at": "2020-08-11T14:09:10.088Z"
      }
    ],
    "notes": [

    ]
  }
]

Example: returns all time entries filtered on period

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?filter=period%3Athis_month

Response

        
          
          Status: 200 OK
        
      
      [
  {
    "id": "296678775804921626",
    "administration_id": 123,
    "contact_id": "296678775700064022",
    "project_id": "296678775746201368",
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T15:09:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2020-08-11T14:09:10.421Z",
    "updated_at": "2020-08-11T14:09:10.421Z",
    "contact": {
      "id": "296678775700064022",
      "firstname": "",
      "lastname": "",
      "company_name": "Foobar Holding B.V."
    },
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": {
      "id": "296678775746201368",
      "name": "My project name",
      "state": "active"
    },
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:10.433Z",
        "updated_at": "2020-08-11T14:09:10.433Z"
      }
    ],
    "notes": [

    ]
  },
  {
    "id": "296678775843718940",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T14:10:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2020-08-11T14:09:10.459Z",
    "updated_at": "2020-08-11T14:09:10.459Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:10.471Z",
        "updated_at": "2020-08-11T14:09:10.471Z"
      }
    ],
    "notes": [

    ]
  },
  {
    "id": "296678775895099166",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T14:10:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2020-08-11T14:09:10.508Z",
    "updated_at": "2020-08-11T14:09:10.508Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:10.518Z",
        "updated_at": "2020-08-11T14:09:10.518Z"
      }
    ],
    "notes": [

    ]
  }
]

Example: returns all time entries filtered on search query

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?query=Custom

Response

        
          
          Status: 200 OK
        
      
      [
  {
    "id": "296678780450113326",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T14:10:00.000Z",
    "description": "Custom description",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2020-08-11T14:09:14.846Z",
    "updated_at": "2020-08-11T14:09:14.846Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:14.859Z",
        "updated_at": "2020-08-11T14:09:14.859Z"
      }
    ],
    "notes": [

    ]
  }
]

Example: returns all time entries filtered on state

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?filter=state%3Anon_billable

Response

        
          
          Status: 200 OK
        
      
      [
  {
    "id": "296678780892612408",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T14:10:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2020-08-11T14:09:15.267Z",
    "updated_at": "2020-08-11T14:09:15.267Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:15.278Z",
        "updated_at": "2020-08-11T14:09:15.278Z"
      }
    ],
    "notes": [

    ]
  }
]

Example: returns paginated time entries on page 1

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?per_page=1

Response

        
          
          Status: 200 OK
        
      
      [
  {
    "id": "296678781234448194",
    "administration_id": 123,
    "contact_id": "296678781131687742",
    "project_id": "296678781177825088",
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T15:09:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2020-08-11T14:09:15.592Z",
    "updated_at": "2020-08-11T14:09:15.592Z",
    "contact": {
      "id": "296678781131687742",
      "firstname": "",
      "lastname": "",
      "company_name": "Foobar Holding B.V."
    },
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": {
      "id": "296678781177825088",
      "name": "My project name",
      "state": "active"
    },
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:15.606Z",
        "updated_at": "2020-08-11T14:09:15.606Z"
      }
    ],
    "notes": [

    ]
  }
]

Example: returns paginated time entries on page 2

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?page=2&per_page=1

Response

        
          
          Status: 200 OK
        
      
      [
  {
    "id": "296678781679044432",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "user_id": 15971545655980,
    "started_at": "2020-08-11T14:09:00.000Z",
    "ended_at": "2020-08-11T14:10:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2020-08-11T14:09:16.018Z",
    "updated_at": "2020-08-11T14:09:16.018Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 15971545655980,
      "name": "Moneybird",
      "created_at": "2020-08-11T14:02:45.969Z",
      "updated_at": "2020-08-11T14:02:46.580Z"
    },
    "project": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 15971545655980,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {
        },
        "created_at": "2020-08-11T14:09:16.028Z",
        "updated_at": "2020-08-11T14:09:16.028Z"
      }
    ],
    "notes": [

    ]
  }
]

Example: returns an error when too many time entries are requested

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?per_page=101

Response

        
          
          Status: 400 Bad Request
        
      
      {
  "error": "Per Page is too big",
  "symbolic": {
    "per_page": "max"
  }
}

Example: returns an error message if filter contact_id is not found

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?filter=contact_id%3A123

Response

        
          
          Status: 404 Not Found
        
      
      {
  "error": "record not found",
  "symbolic": {
    "contact_id": "not_found"
  }
}

Example: returns an error message if filter user_id is not found

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?filter=user_id%3A123

Response

        
          
          Status: 404 Not Found
        
      
      {
  "error": "record not found",
  "symbolic": {
    "user_id": "not_found"
  }
}

Get a time entry by id

GET /time_entries/:id(.:format)

Returns a time entry in the administration.

Example: returns time entry by given id

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries/296678783071553406.json?

Response

        
          
          Status: 200 OK
        
      
      {
  "id": "296678783071553406",
  "administration_id": 123,
  "contact_id": "296678782966695802",
  "project_id": "296678783014930300",
  "user_id": 15971545655980,
  "started_at": "2020-08-11T14:09:00.000Z",
  "ended_at": "2020-08-11T15:09:00.000Z",
  "description": "Test",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2020-08-11T14:09:17.343Z",
  "updated_at": "2020-08-11T14:09:17.343Z",
  "contact": {
    "id": "296678782966695802",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "detail": null,
  "user": {
    "id": 15971545655980,
    "name": "Moneybird",
    "created_at": "2020-08-11T14:02:45.969Z",
    "updated_at": "2020-08-11T14:02:46.580Z"
  },
  "project": {
    "id": "296678783014930300",
    "name": "My project name",
    "state": "active"
  },
  "events": [
    {
      "administration_id": 123,
      "user_id": 15971545655980,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
      },
      "created_at": "2020-08-11T14:09:17.357Z",
      "updated_at": "2020-08-11T14:09:17.357Z"
    }
  ],
  "notes": [

  ]
}

Example: returns 404 when time entry does not exist

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries/34123123.json?

Response

        
          
          Status: 404 Not Found
        
      
      {
  "error": "record not found",
  "symbolic": {
    "id": "not_found"
  }
}

Create a time entry

POST /time_entries(.:format)

Api user needs access to both sales invoices and time entries for this action. started_at and ended_at are rounded down to full minutes when creating a time entry, with a minimum of 1 minute between them.

Parameters

Parameter Type Description
time_entry[user_id] Integer

Required

Should be a valid user id.
time_entry[started_at] Datetime

Required
time_entry[ended_at] Datetime

Required.
time_entry[description] String

Required
time_entry[contact_id] Integer

Should be a valid contact id.
time_entry[project_id] Integer

Should be a valid project id.
time_entry[detail_id] Integer

Should be a valid detail id.
time_entry[billable] Boolean
time_entry[paused_duration] Integer

Total paused duration in seconds, is rounded down to full minutes.
user_agent String

Example: create a basic time entry

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"time_entry":{"started_at":"2020-08-11 14:09:00 UTC","ended_at":"2020-08-11 15:09:00 UTC","description":"Test","contact_id":296678783611570058,"project_id":296678783658755980,"user_id":15971545655980,"billable":false}}' \
  https://moneybird.com/api/v2/123/time_entries

Response

        
          
          Status: 201 Created
        
      
      {
  "id": "296678783757322126",
  "administration_id": 123,
  "contact_id": "296678783611570058",
  "project_id": "296678783658755980",
  "user_id": 15971545655980,
  "started_at": "2020-08-11T14:09:00.000Z",
  "ended_at": "2020-08-11T15:09:00.000Z",
  "description": "Test",
  "paused_duration": 0,
  "billable": false,
  "created_at": "2020-08-11T14:09:17.996Z",
  "updated_at": "2020-08-11T14:09:17.996Z",
  "contact": {
    "id": "296678783611570058",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "detail": null,
  "user": {
    "id": 15971545655980,
    "name": "Moneybird",
    "created_at": "2020-08-11T14:02:45.969Z",
    "updated_at": "2020-08-11T14:02:46.580Z"
  },
  "project": {
    "id": "296678783658755980",
    "name": "My project name",
    "state": "active"
  },
  "events": [
    {
      "administration_id": 123,
      "user_id": 15971545655980,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
      },
      "created_at": "2020-08-11T14:09:18.009Z",
      "updated_at": "2020-08-11T14:09:18.009Z"
    }
  ],
  "notes": [

  ]
}

Example: returns an error when invalid details are provided

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"time_entry":{"started_at":"2020-08-11 14:09:00 UTC","ended_at":"2020-08-11 13:09:00 UTC","user_id":15971545655980,"billable":false}}' \
  https://moneybird.com/api/v2/123/time_entries

Response

        
          
          Status: 422 Unprocessable Entity
        
      
      {
  "error": {
    "ended_at": [
      "cannot be before the start time"
    ],
    "description": [
      "cannot be empty"
    ]
  }
}

Update a time entry

PATCH /time_entries/:id(.:format)

When updating a time entry, provide only the attributes you want to update. The other attributes will not be changed. started_at and ended_at are rounded down to full minutes when updating a time entry, with a minimum of 1 minute between them.

Parameters

Parameter Type Description
time_entry[started_at] Datetime
time_entry[ended_at] Datetime

Required.
time_entry[paused_duration] Integer

Total paused duration in seconds, is rounded down to full minutes.
time_entry[contact_id] Integer

Should be a valid contact id.
time_entry[project_id] Integer

Should be a valid project id.
time_entry[description] String
time_entry[billable] Boolean

Example: updating the time entry description

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPATCH \
  -d '{"time_entry":{"description":"Updated description"}}' \
  https://moneybird.com/api/v2/123/time_entries/296678784171509654

Response

        
          
          Status: 200 OK
        
      
      {
  "id": "296678784171509654",
  "administration_id": 123,
  "contact_id": null,
  "project_id": "296678784115935124",
  "user_id": 15971545655980,
  "started_at": "2020-08-11T14:09:00.000Z",
  "ended_at": "2020-08-11T15:09:00.000Z",
  "description": "Updated description",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2020-08-11T14:09:18.391Z",
  "updated_at": "2020-08-11T14:09:18.458Z",
  "contact": null,
  "detail": null,
  "user": {
    "id": 15971545655980,
    "name": "Moneybird",
    "created_at": "2020-08-11T14:02:45.969Z",
    "updated_at": "2020-08-11T14:02:46.580Z"
  },
  "project": {
    "id": "296678784115935124",
    "name": "My project name",
    "state": "active"
  },
  "events": [
    {
      "administration_id": 123,
      "user_id": 15971545655980,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
      },
      "created_at": "2020-08-11T14:09:18.402Z",
      "updated_at": "2020-08-11T14:09:18.402Z"
    },
    {
      "administration_id": 123,
      "user_id": 15971545655980,
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
      },
      "created_at": "2020-08-11T14:09:18.467Z",
      "updated_at": "2020-08-11T14:09:18.467Z"
    }
  ],
  "notes": [

  ]
}

Delete a time entry

DELETE /time_entries/:id(.:format)

Example: deletes given time entry

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XDELETE \
  -d '{}' \
  https://moneybird.com/api/v2/123/time_entries/296678784557385631.json

Response

        
          
          Status: 204 No Content

Adds note to entity

POST /time_entries/:time_entry_id/notes(.:format)

Parameters

Parameter Type Description
note[note] String

Required. Text for the note or to-do.
note[todo] Boolean

If true the note is a to-do.
note[assignee_id] Integer

Assign to-do to user. Should be a valid user id.

Example: create a note

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"note":{"note":"Text of the note","assignee_id":15971549589536,"todo":true}}' \
  https://moneybird.com/api/v2/123/time_entries/296678784979961768/notes.json

Response

        
          
          Status: 201 Created
        
      
      {
  "id": "296678785054410666",
  "administration_id": 123,
  "entity_id": "296678784979961768",
  "entity_type": "TimeEntry",
  "user_id": 15971545655980,
  "assignee_id": 15971549589536,
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {
  },
  "created_at": "2020-08-11T14:09:19.232Z",
  "updated_at": "2020-08-11T14:09:19.232Z"
}

Destroys note from entity

DELETE /time_entries/:time_entry_id/notes/:id(.:format)

Example: destroy a note

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XDELETE \
  -d '{}' \
  https://moneybird.com/api/v2/123/time_entries/296678785333331890/notes/296678785370032052.json

Response

        
          
          Status: 204 No Content