Create meeting
curl --request POST \
--url https://app.concretehq.com/api/v1/meetings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"meetingNoteTitle": "Q4 Board Meeting Notes",
"provider": "fireflies",
"meetingNoteId": "external_note_123",
"creatorName": "John Doe",
"creatorEmail": "john@example.com",
"attendees": [
{
"name": "Alice Jones",
"email": "alice@acmecorp.com"
},
{
"email": "carmen@sandiego.com"
}
],
"calendarEventId": "cal_event_456",
"calendarEventTitle": "Q4 Board Meeting",
"calendarEventTime": "2024-12-15T14:00:00Z",
"notes": "Meeting notes markdown content here...",
"transcript": "Full meeting transcript markdown content here..."
}
'import requests
url = "https://app.concretehq.com/api/v1/meetings"
payload = {
"meetingNoteTitle": "Q4 Board Meeting Notes",
"provider": "fireflies",
"meetingNoteId": "external_note_123",
"creatorName": "John Doe",
"creatorEmail": "john@example.com",
"attendees": [{
"name": "Alice Jones",
"email": "alice@acmecorp.com"
}, { "email": "carmen@sandiego.com" }],
"calendarEventId": "cal_event_456",
"calendarEventTitle": "Q4 Board Meeting",
"calendarEventTime": "2024-12-15T14:00:00Z",
"notes": "Meeting notes markdown content here...",
"transcript": "Full meeting transcript markdown content here..."
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
meetingNoteTitle: 'Q4 Board Meeting Notes',
provider: 'fireflies',
meetingNoteId: 'external_note_123',
creatorName: 'John Doe',
creatorEmail: 'john@example.com',
attendees: [
{name: 'Alice Jones', email: 'alice@acmecorp.com'},
{email: 'carmen@sandiego.com'}
],
calendarEventId: 'cal_event_456',
calendarEventTitle: 'Q4 Board Meeting',
calendarEventTime: '2024-12-15T14:00:00Z',
notes: 'Meeting notes markdown content here...',
transcript: 'Full meeting transcript markdown content here...'
})
};
fetch('https://app.concretehq.com/api/v1/meetings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.concretehq.com/api/v1/meetings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'meetingNoteTitle' => 'Q4 Board Meeting Notes',
'provider' => 'fireflies',
'meetingNoteId' => 'external_note_123',
'creatorName' => 'John Doe',
'creatorEmail' => 'john@example.com',
'attendees' => [
[
'name' => 'Alice Jones',
'email' => 'alice@acmecorp.com'
],
[
'email' => 'carmen@sandiego.com'
]
],
'calendarEventId' => 'cal_event_456',
'calendarEventTitle' => 'Q4 Board Meeting',
'calendarEventTime' => '2024-12-15T14:00:00Z',
'notes' => 'Meeting notes markdown content here...',
'transcript' => 'Full meeting transcript markdown content here...'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.concretehq.com/api/v1/meetings"
payload := strings.NewReader("{\n \"meetingNoteTitle\": \"Q4 Board Meeting Notes\",\n \"provider\": \"fireflies\",\n \"meetingNoteId\": \"external_note_123\",\n \"creatorName\": \"John Doe\",\n \"creatorEmail\": \"john@example.com\",\n \"attendees\": [\n {\n \"name\": \"Alice Jones\",\n \"email\": \"alice@acmecorp.com\"\n },\n {\n \"email\": \"carmen@sandiego.com\"\n }\n ],\n \"calendarEventId\": \"cal_event_456\",\n \"calendarEventTitle\": \"Q4 Board Meeting\",\n \"calendarEventTime\": \"2024-12-15T14:00:00Z\",\n \"notes\": \"Meeting notes markdown content here...\",\n \"transcript\": \"Full meeting transcript markdown content here...\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.concretehq.com/api/v1/meetings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"meetingNoteTitle\": \"Q4 Board Meeting Notes\",\n \"provider\": \"fireflies\",\n \"meetingNoteId\": \"external_note_123\",\n \"creatorName\": \"John Doe\",\n \"creatorEmail\": \"john@example.com\",\n \"attendees\": [\n {\n \"name\": \"Alice Jones\",\n \"email\": \"alice@acmecorp.com\"\n },\n {\n \"email\": \"carmen@sandiego.com\"\n }\n ],\n \"calendarEventId\": \"cal_event_456\",\n \"calendarEventTitle\": \"Q4 Board Meeting\",\n \"calendarEventTime\": \"2024-12-15T14:00:00Z\",\n \"notes\": \"Meeting notes markdown content here...\",\n \"transcript\": \"Full meeting transcript markdown content here...\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.concretehq.com/api/v1/meetings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"meetingNoteTitle\": \"Q4 Board Meeting Notes\",\n \"provider\": \"fireflies\",\n \"meetingNoteId\": \"external_note_123\",\n \"creatorName\": \"John Doe\",\n \"creatorEmail\": \"john@example.com\",\n \"attendees\": [\n {\n \"name\": \"Alice Jones\",\n \"email\": \"alice@acmecorp.com\"\n },\n {\n \"email\": \"carmen@sandiego.com\"\n }\n ],\n \"calendarEventId\": \"cal_event_456\",\n \"calendarEventTitle\": \"Q4 Board Meeting\",\n \"calendarEventTime\": \"2024-12-15T14:00:00Z\",\n \"notes\": \"Meeting notes markdown content here...\",\n \"transcript\": \"Full meeting transcript markdown content here...\"\n}"
response = http.request(request)
puts response.read_body{
"publicId": "abc123def456"
}{
"error": "Not found"
}{
"error": "Not found"
}Meetings
Create meeting
Create and manage meetings imported from external sources like meeting recorders and note-taking apps.
This endpoint is designed to integrate with external meeting platforms and note-taking applications, allowing you to import meeting data into Concrete for portfolio intelligence analysis.
Key Features:
- Import from various providers (Fireflies, Granola, Notion, etc.)
- Update existing meetings using meetingNoteId
- Flexible content requirements (need at least one of: title, notes, or transcript)
- Automatic workspace member matching via creatorEmail
- Support for both meeting notes and calendar event data
POST
/
meetings
Create meeting
curl --request POST \
--url https://app.concretehq.com/api/v1/meetings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"meetingNoteTitle": "Q4 Board Meeting Notes",
"provider": "fireflies",
"meetingNoteId": "external_note_123",
"creatorName": "John Doe",
"creatorEmail": "john@example.com",
"attendees": [
{
"name": "Alice Jones",
"email": "alice@acmecorp.com"
},
{
"email": "carmen@sandiego.com"
}
],
"calendarEventId": "cal_event_456",
"calendarEventTitle": "Q4 Board Meeting",
"calendarEventTime": "2024-12-15T14:00:00Z",
"notes": "Meeting notes markdown content here...",
"transcript": "Full meeting transcript markdown content here..."
}
'import requests
url = "https://app.concretehq.com/api/v1/meetings"
payload = {
"meetingNoteTitle": "Q4 Board Meeting Notes",
"provider": "fireflies",
"meetingNoteId": "external_note_123",
"creatorName": "John Doe",
"creatorEmail": "john@example.com",
"attendees": [{
"name": "Alice Jones",
"email": "alice@acmecorp.com"
}, { "email": "carmen@sandiego.com" }],
"calendarEventId": "cal_event_456",
"calendarEventTitle": "Q4 Board Meeting",
"calendarEventTime": "2024-12-15T14:00:00Z",
"notes": "Meeting notes markdown content here...",
"transcript": "Full meeting transcript markdown content here..."
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
meetingNoteTitle: 'Q4 Board Meeting Notes',
provider: 'fireflies',
meetingNoteId: 'external_note_123',
creatorName: 'John Doe',
creatorEmail: 'john@example.com',
attendees: [
{name: 'Alice Jones', email: 'alice@acmecorp.com'},
{email: 'carmen@sandiego.com'}
],
calendarEventId: 'cal_event_456',
calendarEventTitle: 'Q4 Board Meeting',
calendarEventTime: '2024-12-15T14:00:00Z',
notes: 'Meeting notes markdown content here...',
transcript: 'Full meeting transcript markdown content here...'
})
};
fetch('https://app.concretehq.com/api/v1/meetings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.concretehq.com/api/v1/meetings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'meetingNoteTitle' => 'Q4 Board Meeting Notes',
'provider' => 'fireflies',
'meetingNoteId' => 'external_note_123',
'creatorName' => 'John Doe',
'creatorEmail' => 'john@example.com',
'attendees' => [
[
'name' => 'Alice Jones',
'email' => 'alice@acmecorp.com'
],
[
'email' => 'carmen@sandiego.com'
]
],
'calendarEventId' => 'cal_event_456',
'calendarEventTitle' => 'Q4 Board Meeting',
'calendarEventTime' => '2024-12-15T14:00:00Z',
'notes' => 'Meeting notes markdown content here...',
'transcript' => 'Full meeting transcript markdown content here...'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.concretehq.com/api/v1/meetings"
payload := strings.NewReader("{\n \"meetingNoteTitle\": \"Q4 Board Meeting Notes\",\n \"provider\": \"fireflies\",\n \"meetingNoteId\": \"external_note_123\",\n \"creatorName\": \"John Doe\",\n \"creatorEmail\": \"john@example.com\",\n \"attendees\": [\n {\n \"name\": \"Alice Jones\",\n \"email\": \"alice@acmecorp.com\"\n },\n {\n \"email\": \"carmen@sandiego.com\"\n }\n ],\n \"calendarEventId\": \"cal_event_456\",\n \"calendarEventTitle\": \"Q4 Board Meeting\",\n \"calendarEventTime\": \"2024-12-15T14:00:00Z\",\n \"notes\": \"Meeting notes markdown content here...\",\n \"transcript\": \"Full meeting transcript markdown content here...\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.concretehq.com/api/v1/meetings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"meetingNoteTitle\": \"Q4 Board Meeting Notes\",\n \"provider\": \"fireflies\",\n \"meetingNoteId\": \"external_note_123\",\n \"creatorName\": \"John Doe\",\n \"creatorEmail\": \"john@example.com\",\n \"attendees\": [\n {\n \"name\": \"Alice Jones\",\n \"email\": \"alice@acmecorp.com\"\n },\n {\n \"email\": \"carmen@sandiego.com\"\n }\n ],\n \"calendarEventId\": \"cal_event_456\",\n \"calendarEventTitle\": \"Q4 Board Meeting\",\n \"calendarEventTime\": \"2024-12-15T14:00:00Z\",\n \"notes\": \"Meeting notes markdown content here...\",\n \"transcript\": \"Full meeting transcript markdown content here...\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.concretehq.com/api/v1/meetings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"meetingNoteTitle\": \"Q4 Board Meeting Notes\",\n \"provider\": \"fireflies\",\n \"meetingNoteId\": \"external_note_123\",\n \"creatorName\": \"John Doe\",\n \"creatorEmail\": \"john@example.com\",\n \"attendees\": [\n {\n \"name\": \"Alice Jones\",\n \"email\": \"alice@acmecorp.com\"\n },\n {\n \"email\": \"carmen@sandiego.com\"\n }\n ],\n \"calendarEventId\": \"cal_event_456\",\n \"calendarEventTitle\": \"Q4 Board Meeting\",\n \"calendarEventTime\": \"2024-12-15T14:00:00Z\",\n \"notes\": \"Meeting notes markdown content here...\",\n \"transcript\": \"Full meeting transcript markdown content here...\"\n}"
response = http.request(request)
puts response.read_body{
"publicId": "abc123def456"
}{
"error": "Not found"
}{
"error": "Not found"
}Authorizations
API key authentication using Bearer token format
Body
application/json
- Option 1
- Option 2
- Option 3
- Option 4
Meeting data for import from external sources. At least one of the following fields must be provided:
meetingNoteTitle, calendarEventTitle, notes, or transcript.
Title from the external meeting note. This is one of the four fields that can satisfy the minimum content requirement.
Example:
"Q4 Board Meeting Notes"
External source (e.g., "fireflies", "granola"). Used to facilitate link backs using the meetingNoteId. Common providers include meeting recording services and note-taking applications.
Example:
"fireflies"
External system's meeting note identifier. Updates existing meeting if matched. This allows you to update the same meeting multiple times from your external system.
Example:
"external_note_123"
Name of meeting creator
Example:
"John Doe"
Email of meeting creator. Matches on workspace members to take ownership of the meeting from the API key holder. If this email matches a workspace member, they will become the owner of the imported meeting.
Example:
"john@example.com"
Array of attendee objects. Each object may contain an optional name and/or email. At least one of name or email should be provided for each attendee.
Show child attributes
Show child attributes
Example:
[
{
"name": "Alice Jones",
"email": "alice@acmecorp.com"
},
{ "email": "carmen@sandiego.com" }
]
Calendar system's event identifier for linking to original calendar event
Example:
"cal_event_456"
Title from calendar event. This is one of the four fields that can satisfy the minimum content requirement.
Example:
"Q4 Board Meeting"
Meeting date/time (ISO 8601 format). Defaults to current time if not provided. Used for chronological organization of meetings.
Example:
"2024-12-15T14:00:00Z"
Meeting notes content in markdown format. This is one of the four fields that can satisfy the minimum content requirement. Supports rich formatting for detailed meeting records.
Example:
"Meeting notes markdown content here..."
Meeting transcript content in markdown format. This is one of the four fields that can satisfy the minimum content requirement. Full transcript for comprehensive meeting analysis.
Example:
"Full meeting transcript markdown content here..."
Response
Meeting created successfully
Created meeting public ID
Example:
"abc123def456"