Getting startedGeneralCRMDealsInvoicesSubscriptionsProductsTicketsTimetracking & TasksCallsMeetingsPlanningProjectsExternal costsNotesFilesUsers & TeamsCustom Fields

Teamleader Meetings API

This document assumes you have your API key and know how to perform a POST request (see Getting started)

This part of the api allows you to manage meetings from Teamleader.

Adding meetings

Add a new meeting

API endpoint: https://app.teamleader.eu/api/addMeeting.php

Required POST parameters

  • start_date: start_date: start_date of the meeting
  • user_id: user_id: user_id of the attending user
  • title: title: title of the meeting
  • description: description: description of the meeting
  • duration: duration: duration in minutes

Optional POST parameters

  • milestone_id: milestone_id: milestone of the corresponding project
  • custom_field_ID: replace ID by the ID of your custom field.(eg custom_field_310)

Sample output

Example output: JSON array indicating success or failure of the operation

Updating meetings

Updating an existing meeting

API endpoint: https://app.teamleader.eu/api/updateMeeting.php

Required POST parameters

  • meeting_id: id: id of the meeting

Optional POST parameters

  • title: string: title of the meeting
  • start_date: integer: start date of the meeting as Unix timestamp (seconds)
  • duration_minutes: integer: duration of the meeting in minutes

Sample output

Example output: JSON array indicating success or failure of the operation

Adding a contact to a meeting

API endpoint: https://app.teamleader.eu/api/addContactToMeeting.php

Required POST parameters

  • meeting_id: id: id of the meeting
  • contact_id: id: id of the contact

Sample output

Example output: JSON array indicating success or failure of the operation

Removing a contact from a meeting

API endpoint: https://app.teamleader.eu/api/removeContactFromMeeting.php

Required POST parameters

  • meeting_id: id: id of the meeting
  • contact_id: id: id of the contact

Sample output

Example output: JSON array indicating success or failure of the operation

Searching meetings

Searching all meetings

API endpoint: https://app.teamleader.eu/api/getMeetings.php

Required POST parameters

  • amount: integer: the amount of meetings returned per request (1 - 100)
  • pageno: integer: the current page (the first page is 0)

Optional POST parameters

  • date_from: date (dd/mm/yyyy): the start date of the period you are requesting meetings for
  • date_to: date (dd/mm/yyyy): the end date of the period you are requesting meetings for
  • project_id: integer: the ID of the project you want to restrict this search to

Sample output

Example output: JSON array containing information about the meetings
  • id: id of the meeting
  • title: string
  • duration_minutes: integer
  • date_timestamp: unix timestamp
  • date_day: dd/mm/yyyy
  • date_hour: hh:mm
  • related_project_id: id of the related project
  • related_milestone_id: id of the related milestone

Fetching meeting information

API endpoint: https://app.teamleader.eu/api/getMeeting.php

Required POST parameters

  • meeting_id: integer: the ID of the meeting

Sample output

Example output: JSON array containing info about the meeting including attendance information

  • id: id of the meeting
  • title: string
  • duration_minutes: integer
  • date_timestamp: unix timestamp
  • date_day: dd/mm/yyyy
  • date_hour: hh:mm
  • attending_internal: array containing the user_id, name (string), gsm, telephone and email (string) of the attending colleagues
  • attending_external: array containing the creator_id, canceller_id, location (string), location_detailled (type, contact or company)
  • project_id: id of the meeting
  • related_milestone_id: string
  • date_added: integer
  • date_added_formatted: unix timestamp
  • related_sale_id: dd/mm/yyyy
  • custom_fields: hour

Deleting a meeting

API endpoint: https://app.teamleader.eu/api/deleteMeeting.php

Required POST parameters

  • meeting_id: integer: ID of the meeting

Sample output

Example output: Status code 204 will be returned if the deletion is successful. If the request is unsuccessful status code 400 will be returned.