Create a company
curl --request POST \
--url https://api.morphic.io/api/companies/ \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"city": "San Francisco",
"company_size": "51-200",
"country": "US",
"description": "Leading provider of innovative solutions.",
"domains": [
"acme.com"
],
"email": "info@acme.com",
"employee_count": 150,
"industry": "Technology",
"name": "Acme Corporation",
"state": "CA",
"website": "https://acme.com"
}
'import requests
url = "https://api.morphic.io/api/companies/"
payload = {
"city": "San Francisco",
"company_size": "51-200",
"country": "US",
"description": "Leading provider of innovative solutions.",
"domains": ["acme.com"],
"email": "info@acme.com",
"employee_count": 150,
"industry": "Technology",
"name": "Acme Corporation",
"state": "CA",
"website": "https://acme.com"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
city: 'San Francisco',
company_size: '51-200',
country: 'US',
description: 'Leading provider of innovative solutions.',
domains: ['acme.com'],
email: 'info@acme.com',
employee_count: 150,
industry: 'Technology',
name: 'Acme Corporation',
state: 'CA',
website: 'https://acme.com'
})
};
fetch('https://api.morphic.io/api/companies/', 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.morphic.io/api/companies/",
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([
'city' => 'San Francisco',
'company_size' => '51-200',
'country' => 'US',
'description' => 'Leading provider of innovative solutions.',
'domains' => [
'acme.com'
],
'email' => 'info@acme.com',
'employee_count' => 150,
'industry' => 'Technology',
'name' => 'Acme Corporation',
'state' => 'CA',
'website' => 'https://acme.com'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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.morphic.io/api/companies/"
payload := strings.NewReader("{\n \"city\": \"San Francisco\",\n \"company_size\": \"51-200\",\n \"country\": \"US\",\n \"description\": \"Leading provider of innovative solutions.\",\n \"domains\": [\n \"acme.com\"\n ],\n \"email\": \"info@acme.com\",\n \"employee_count\": 150,\n \"industry\": \"Technology\",\n \"name\": \"Acme Corporation\",\n \"state\": \"CA\",\n \"website\": \"https://acme.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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://api.morphic.io/api/companies/")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"city\": \"San Francisco\",\n \"company_size\": \"51-200\",\n \"country\": \"US\",\n \"description\": \"Leading provider of innovative solutions.\",\n \"domains\": [\n \"acme.com\"\n ],\n \"email\": \"info@acme.com\",\n \"employee_count\": 150,\n \"industry\": \"Technology\",\n \"name\": \"Acme Corporation\",\n \"state\": \"CA\",\n \"website\": \"https://acme.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.morphic.io/api/companies/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"city\": \"San Francisco\",\n \"company_size\": \"51-200\",\n \"country\": \"US\",\n \"description\": \"Leading provider of innovative solutions.\",\n \"domains\": [\n \"acme.com\"\n ],\n \"email\": \"info@acme.com\",\n \"employee_count\": 150,\n \"industry\": \"Technology\",\n \"name\": \"Acme Corporation\",\n \"state\": \"CA\",\n \"website\": \"https://acme.com\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"custom_fields": {},
"domains": "<string>",
"industry": "<string>",
"company_size": "<string>",
"employee_count": 1,
"annual_revenue": 1,
"phone": "<string>",
"email": "jsmith@example.com",
"website": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"postal_code": "<string>",
"linkedin_url": "<string>",
"facebook_url": "<string>",
"instagram_url": "<string>",
"twitter_url": "<string>",
"twitter_handle": "<string>",
"twitter_follower_count": 1,
"description": "<string>",
"notes": "<string>",
"logo_url": "<string>",
"connection_strength": "<string>",
"status": "<string>",
"categories": [
"<string>"
],
"team_ids": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"associated_deal_ids": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"metadata": {},
"enrichment": {},
"enrichment_provider": "<string>",
"enrichment_last_updated": "2023-11-07T05:31:56Z",
"enrichment_status": "<string>",
"is_favorite": false
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Companies
Create a company
Create a new company in the CRM.
POST
/
api
/
companies
/
Create a company
curl --request POST \
--url https://api.morphic.io/api/companies/ \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"city": "San Francisco",
"company_size": "51-200",
"country": "US",
"description": "Leading provider of innovative solutions.",
"domains": [
"acme.com"
],
"email": "info@acme.com",
"employee_count": 150,
"industry": "Technology",
"name": "Acme Corporation",
"state": "CA",
"website": "https://acme.com"
}
'import requests
url = "https://api.morphic.io/api/companies/"
payload = {
"city": "San Francisco",
"company_size": "51-200",
"country": "US",
"description": "Leading provider of innovative solutions.",
"domains": ["acme.com"],
"email": "info@acme.com",
"employee_count": 150,
"industry": "Technology",
"name": "Acme Corporation",
"state": "CA",
"website": "https://acme.com"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
city: 'San Francisco',
company_size: '51-200',
country: 'US',
description: 'Leading provider of innovative solutions.',
domains: ['acme.com'],
email: 'info@acme.com',
employee_count: 150,
industry: 'Technology',
name: 'Acme Corporation',
state: 'CA',
website: 'https://acme.com'
})
};
fetch('https://api.morphic.io/api/companies/', 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.morphic.io/api/companies/",
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([
'city' => 'San Francisco',
'company_size' => '51-200',
'country' => 'US',
'description' => 'Leading provider of innovative solutions.',
'domains' => [
'acme.com'
],
'email' => 'info@acme.com',
'employee_count' => 150,
'industry' => 'Technology',
'name' => 'Acme Corporation',
'state' => 'CA',
'website' => 'https://acme.com'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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.morphic.io/api/companies/"
payload := strings.NewReader("{\n \"city\": \"San Francisco\",\n \"company_size\": \"51-200\",\n \"country\": \"US\",\n \"description\": \"Leading provider of innovative solutions.\",\n \"domains\": [\n \"acme.com\"\n ],\n \"email\": \"info@acme.com\",\n \"employee_count\": 150,\n \"industry\": \"Technology\",\n \"name\": \"Acme Corporation\",\n \"state\": \"CA\",\n \"website\": \"https://acme.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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://api.morphic.io/api/companies/")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"city\": \"San Francisco\",\n \"company_size\": \"51-200\",\n \"country\": \"US\",\n \"description\": \"Leading provider of innovative solutions.\",\n \"domains\": [\n \"acme.com\"\n ],\n \"email\": \"info@acme.com\",\n \"employee_count\": 150,\n \"industry\": \"Technology\",\n \"name\": \"Acme Corporation\",\n \"state\": \"CA\",\n \"website\": \"https://acme.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.morphic.io/api/companies/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"city\": \"San Francisco\",\n \"company_size\": \"51-200\",\n \"country\": \"US\",\n \"description\": \"Leading provider of innovative solutions.\",\n \"domains\": [\n \"acme.com\"\n ],\n \"email\": \"info@acme.com\",\n \"employee_count\": 150,\n \"industry\": \"Technology\",\n \"name\": \"Acme Corporation\",\n \"state\": \"CA\",\n \"website\": \"https://acme.com\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"custom_fields": {},
"domains": "<string>",
"industry": "<string>",
"company_size": "<string>",
"employee_count": 1,
"annual_revenue": 1,
"phone": "<string>",
"email": "jsmith@example.com",
"website": "<string>",
"address": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"postal_code": "<string>",
"linkedin_url": "<string>",
"facebook_url": "<string>",
"instagram_url": "<string>",
"twitter_url": "<string>",
"twitter_handle": "<string>",
"twitter_follower_count": 1,
"description": "<string>",
"notes": "<string>",
"logo_url": "<string>",
"connection_strength": "<string>",
"status": "<string>",
"categories": [
"<string>"
],
"team_ids": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"associated_deal_ids": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"metadata": {},
"enrichment": {},
"enrichment_provider": "<string>",
"enrichment_last_updated": "2023-11-07T05:31:56Z",
"enrichment_status": "<string>",
"is_favorite": false
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
API key (sk_xxx) from Developer Settings. No X-Account-ID needed.
Headers
Body
application/json
Required string length:
1 - 255Required range:
x >= 0Required range:
x >= 0Required range:
x >= 0weak, medium, or strong
lead, qualified, engaged, opportunity, customer, inactive
Person IDs for team members
Deal IDs to associate with company
Response
Successful Response
Required string length:
1 - 255Backward compatibility - returns metadata as custom_fields.
Required range:
x >= 0Required range:
x >= 0Required range:
x >= 0weak, medium, or strong
lead, qualified, engaged, opportunity, customer, inactive
Team members with id and name
Show child attributes
Show child attributes
Associated deals with id and name
Show child attributes
Show child attributes
Whether this record is favorited by the current user