curl --request PUT \
--url https://api.hubapi.com/crm-associations/v1/associations \
--header 'Content-Type: application/json' \
--data '
{
"fromObjectId": "<string>",
"toObjectId": "<string>",
"category": "<string>",
"definitionId": "<string>"
}
'import requests
url = "https://api.hubapi.com/crm-associations/v1/associations"
payload = {
"fromObjectId": "<string>",
"toObjectId": "<string>",
"category": "<string>",
"definitionId": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
fromObjectId: '<string>',
toObjectId: '<string>',
category: '<string>',
definitionId: '<string>'
})
};
fetch('https://api.hubapi.com/crm-associations/v1/associations', 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://api.hubapi.com/crm-associations/v1/associations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'fromObjectId' => '<string>',
'toObjectId' => '<string>',
'category' => '<string>',
'definitionId' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"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://api.hubapi.com/crm-associations/v1/associations"
payload := strings.NewReader("{\n \"fromObjectId\": \"<string>\",\n \"toObjectId\": \"<string>\",\n \"category\": \"<string>\",\n \"definitionId\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
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.put("https://api.hubapi.com/crm-associations/v1/associations")
.header("Content-Type", "application/json")
.body("{\n \"fromObjectId\": \"<string>\",\n \"toObjectId\": \"<string>\",\n \"category\": \"<string>\",\n \"definitionId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hubapi.com/crm-associations/v1/associations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"fromObjectId\": \"<string>\",\n \"toObjectId\": \"<string>\",\n \"category\": \"<string>\",\n \"definitionId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"fromObjectId": 496346,
"toObjectId": 176602,
"category": "HUBSPOT_DEFINED",
"definitionId": 15
}Associate CRM objects
This endpoint is used to associate two CRM objects. Use case for this endpoint: You can use this endpoint to associate a ticket with a contact or to associate a line item with a deal. See all possible associations on the CRM Associations Overview. If you need to make multiple associations (either to the same object or across multiple objects) you can use the batch associations endpoint.
curl --request PUT \
--url https://api.hubapi.com/crm-associations/v1/associations \
--header 'Content-Type: application/json' \
--data '
{
"fromObjectId": "<string>",
"toObjectId": "<string>",
"category": "<string>",
"definitionId": "<string>"
}
'import requests
url = "https://api.hubapi.com/crm-associations/v1/associations"
payload = {
"fromObjectId": "<string>",
"toObjectId": "<string>",
"category": "<string>",
"definitionId": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
fromObjectId: '<string>',
toObjectId: '<string>',
category: '<string>',
definitionId: '<string>'
})
};
fetch('https://api.hubapi.com/crm-associations/v1/associations', 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://api.hubapi.com/crm-associations/v1/associations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'fromObjectId' => '<string>',
'toObjectId' => '<string>',
'category' => '<string>',
'definitionId' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"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://api.hubapi.com/crm-associations/v1/associations"
payload := strings.NewReader("{\n \"fromObjectId\": \"<string>\",\n \"toObjectId\": \"<string>\",\n \"category\": \"<string>\",\n \"definitionId\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
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.put("https://api.hubapi.com/crm-associations/v1/associations")
.header("Content-Type", "application/json")
.body("{\n \"fromObjectId\": \"<string>\",\n \"toObjectId\": \"<string>\",\n \"category\": \"<string>\",\n \"definitionId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hubapi.com/crm-associations/v1/associations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"fromObjectId\": \"<string>\",\n \"toObjectId\": \"<string>\",\n \"category\": \"<string>\",\n \"definitionId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"fromObjectId": 496346,
"toObjectId": 176602,
"category": "HUBSPOT_DEFINED",
"definitionId": 15
}Body
The ID of the object being associated.
The ID of the object the from object is being associated with.
The category of the association. Currently this must be "HUBSPOT_DEFINED"
The ID of the association definition. See the table on the overview page for a list of these IDs.
Response
Successful response - This endpoint is used to associate two CRM objects
The response is of type object.
Was this page helpful?