POST v1/Companies({CompanyId})/CustomerFull

This call creates a Customer in Cova will all their attributes

Information:

Base URL:

https://api.covasoft.net/crm

To minimize customer duplication, always Search for potential matches prior to creating new customer records.

Request Information

URI Parameters

Name	Description	Type	Additional information
CompanyId	Company Id from your onboarding package	integer	Required

Body Parameters

The Customer attributes for Customer Creation

CustomerFullPost

Name	Type	Additional information
Addresses	Collection of Address	None.
ContactMethods	Collection of ContactMethod	None.
CustomerExtensions	Collection of CustomerExtension	None.
CustomerTypeId	integer	None.
Title	string	None.
PrimaryName	string	None.
AlternateName	string	None.
MiddleName	string	None.
FamilyName	string	None.
ReferralSource	string	None.
DateOfBirth	date	None.
PricingGroupId	integer	None.
Notes	string	None.
UniqueIdentifier	string	None.
Disabled	boolean	None.
DoNotContact	boolean	None.

Request Formats

application/json, text/json

Sample:

{
  "Addresses": [
    {
      "AddressLine1": "sample string 1",
      "AddressLine2": "sample string 2",
      "City": "sample string 3",
      "StateName": "sample string 4",
      "CountryName": "sample string 5",
      "Zip": 1,
      "Id": "bc921b35-c7b6-4c81-ba49-4458c99ff60f",
      "CustomerId": "4a1c1a32-5920-4b17-8fe2-b90e050e0301",
      "AddressTypeId": 8,
      "AddressType": "sample string 9",
      "Default": true,
      "DoNotContact": true,
      "CountryCode": "sample string 12",
      "Country": "sample string 13",
      "Locality": "sample string 14",
      "StateCode": "sample string 15",
      "State": "sample string 16",
      "PostalCode": "sample string 17",
      "PostOfficeBoxNumber": "sample string 18",
      "StreetAddress1": "sample string 19",
      "Notes": "sample string 20",
      "StreetAddress2": "sample string 21",
      "Version": 22,
      "AttentionTo": "sample string 23",
      "Phone": "sample string 24",
      "Email": "sample string 25"
    },
    {
      "AddressLine1": "sample string 1",
      "AddressLine2": "sample string 2",
      "City": "sample string 3",
      "StateName": "sample string 4",
      "CountryName": "sample string 5",
      "Zip": 1,
      "Id": "bc921b35-c7b6-4c81-ba49-4458c99ff60f",
      "CustomerId": "4a1c1a32-5920-4b17-8fe2-b90e050e0301",
      "AddressTypeId": 8,
      "AddressType": "sample string 9",
      "Default": true,
      "DoNotContact": true,
      "CountryCode": "sample string 12",
      "Country": "sample string 13",
      "Locality": "sample string 14",
      "StateCode": "sample string 15",
      "State": "sample string 16",
      "PostalCode": "sample string 17",
      "PostOfficeBoxNumber": "sample string 18",
      "StreetAddress1": "sample string 19",
      "Notes": "sample string 20",
      "StreetAddress2": "sample string 21",
      "Version": 22,
      "AttentionTo": "sample string 23",
      "Phone": "sample string 24",
      "Email": "sample string 25"
    }
  ],
  "ContactMethods": [
    {
      "Value": "sample string 1",
      "Id": "c1ae4eb9-4881-412a-8206-1fc702d1c257",
      "CustomerId": "758af814-1d52-470a-b4cb-64dfb22ef712",
      "ContactMethodCategoryId": 4,
      "ContactMethodCategory": "sample string 5",
      "ContactMethodTypeId": 6,
      "ContactMethodType": "sample string 7",
      "DoNotContact": true,
      "Default": true,
      "Notes": "sample string 10",
      "Version": 11
    },
    {
      "Value": "sample string 1",
      "Id": "c1ae4eb9-4881-412a-8206-1fc702d1c257",
      "CustomerId": "758af814-1d52-470a-b4cb-64dfb22ef712",
      "ContactMethodCategoryId": 4,
      "ContactMethodCategory": "sample string 5",
      "ContactMethodTypeId": 6,
      "ContactMethodType": "sample string 7",
      "DoNotContact": true,
      "Default": true,
      "Notes": "sample string 10",
      "Version": 11
    }
  ],
  "CustomerExtensions": [
    {
      "Value": "sample string 1",
      "Id": "96f1eeb2-eecd-40f9-8b8b-0dbb89cadcf8",
      "CustomerId": "b03c7912-fd1b-449c-a9bb-b71761e27905",
      "ExtensionTypeId": 4,
      "ExtensionType": "sample string 5",
      "ExtensionTypeFeature": "sample string 6",
      "Version": 7
    },
    {
      "Value": "sample string 1",
      "Id": "96f1eeb2-eecd-40f9-8b8b-0dbb89cadcf8",
      "CustomerId": "b03c7912-fd1b-449c-a9bb-b71761e27905",
      "ExtensionTypeId": 4,
      "ExtensionType": "sample string 5",
      "ExtensionTypeFeature": "sample string 6",
      "Version": 7
    }
  ],
  "CustomerTypeId": 1,
  "Title": "sample string 2",
  "PrimaryName": "sample string 3",
  "AlternateName": "sample string 4",
  "MiddleName": "sample string 5",
  "FamilyName": "sample string 6",
  "ReferralSource": "sample string 7",
  "DateOfBirth": "2025-08-21T05:39:04.3207768+00:00",
  "PricingGroupId": 9,
  "Notes": "sample string 10",
  "UniqueIdentifier": "sample string 11",
  "Disabled": true,
  "DoNotContact": true
}

Response Information

Resource Description

Returns Customer Posted in Cova will all their attributes

CustomerFullReturn

Name	Type	Additional information
Addresses	Collection of Address	None.
ContactMethods	Collection of ContactMethod	None.
CustomerExtensions	Collection of CustomerExtension	None.
RelatedCustomers	Collection of RelatedCustomer	None.
MemberOf	Collection of MemberOf	None.
Documents	Collection of Document	None.
MergedCustomers	Collection of globally unique identifier	None.
PrimaryName	string	None.
Title	string	None.
AlternateName	string	None.
MiddleName	string	None.
FamilyName	string	None.
ReferralSource	string	None.
Notes	string	None.
UniqueIdentifier	string	None.
Id	globally unique identifier	None.
CustomerTypeId	integer	None.
CustomerType	string	None.
DateOfBirth	date	None.
PricingGroupId	integer	None.
Disabled	boolean	None.
DoNotContact	boolean	None.
Version	integer	None.
MergedIntoCustomerId	globally unique identifier	None.
LastModifiedDateUtc	date	None.

Response Formats

application/json, text/json

Sample:

{
  "Addresses": [
    {
      "AddressLine1": "sample string 1",
      "AddressLine2": "sample string 2",
      "City": "sample string 3",
      "StateName": "sample string 4",
      "CountryName": "sample string 5",
      "Zip": 1,
      "Id": "17136ea1-7e4d-478e-8a01-d0b7eacdefbf",
      "CustomerId": "38cdae05-3fdb-4773-9871-f931ee0e93d4",
      "AddressTypeId": 8,
      "AddressType": "sample string 9",
      "Default": true,
      "DoNotContact": true,
      "CountryCode": "sample string 12",
      "Country": "sample string 13",
      "Locality": "sample string 14",
      "StateCode": "sample string 15",
      "State": "sample string 16",
      "PostalCode": "sample string 17",
      "PostOfficeBoxNumber": "sample string 18",
      "StreetAddress1": "sample string 19",
      "Notes": "sample string 20",
      "StreetAddress2": "sample string 21",
      "Version": 22,
      "AttentionTo": "sample string 23",
      "Phone": "sample string 24",
      "Email": "sample string 25"
    },
    {
      "AddressLine1": "sample string 1",
      "AddressLine2": "sample string 2",
      "City": "sample string 3",
      "StateName": "sample string 4",
      "CountryName": "sample string 5",
      "Zip": 1,
      "Id": "17136ea1-7e4d-478e-8a01-d0b7eacdefbf",
      "CustomerId": "38cdae05-3fdb-4773-9871-f931ee0e93d4",
      "AddressTypeId": 8,
      "AddressType": "sample string 9",
      "Default": true,
      "DoNotContact": true,
      "CountryCode": "sample string 12",
      "Country": "sample string 13",
      "Locality": "sample string 14",
      "StateCode": "sample string 15",
      "State": "sample string 16",
      "PostalCode": "sample string 17",
      "PostOfficeBoxNumber": "sample string 18",
      "StreetAddress1": "sample string 19",
      "Notes": "sample string 20",
      "StreetAddress2": "sample string 21",
      "Version": 22,
      "AttentionTo": "sample string 23",
      "Phone": "sample string 24",
      "Email": "sample string 25"
    }
  ],
  "ContactMethods": [
    {
      "Value": "sample string 1",
      "Id": "52d0b309-a5ac-4223-8f28-8605566d5741",
      "CustomerId": "a516a7f1-910c-4a62-9411-bc9b733eedd7",
      "ContactMethodCategoryId": 4,
      "ContactMethodCategory": "sample string 5",
      "ContactMethodTypeId": 6,
      "ContactMethodType": "sample string 7",
      "DoNotContact": true,
      "Default": true,
      "Notes": "sample string 10",
      "Version": 11
    },
    {
      "Value": "sample string 1",
      "Id": "52d0b309-a5ac-4223-8f28-8605566d5741",
      "CustomerId": "a516a7f1-910c-4a62-9411-bc9b733eedd7",
      "ContactMethodCategoryId": 4,
      "ContactMethodCategory": "sample string 5",
      "ContactMethodTypeId": 6,
      "ContactMethodType": "sample string 7",
      "DoNotContact": true,
      "Default": true,
      "Notes": "sample string 10",
      "Version": 11
    }
  ],
  "CustomerExtensions": [
    {
      "Value": "sample string 1",
      "Id": "8513835f-8eda-4c66-9bfa-3c8f6a22ef93",
      "CustomerId": "73f0806d-3237-4bff-b39c-0811f31eb125",
      "ExtensionTypeId": 4,
      "ExtensionType": "sample string 5",
      "ExtensionTypeFeature": "sample string 6",
      "Version": 7
    },
    {
      "Value": "sample string 1",
      "Id": "8513835f-8eda-4c66-9bfa-3c8f6a22ef93",
      "CustomerId": "73f0806d-3237-4bff-b39c-0811f31eb125",
      "ExtensionTypeId": 4,
      "ExtensionType": "sample string 5",
      "ExtensionTypeFeature": "sample string 6",
      "Version": 7
    }
  ],
  "RelatedCustomers": [
    {
      "Id": "sample string 1",
      "ParentCustomerId": "sample string 2"
    },
    {
      "Id": "sample string 1",
      "ParentCustomerId": "sample string 2"
    }
  ],
  "MemberOf": [
    {
      "Id": "sample string 1",
      "ChildCustomerId": "sample string 2"
    },
    {
      "Id": "sample string 1",
      "ChildCustomerId": "sample string 2"
    }
  ],
  "Documents": [
    {
      "Id": "sample string 1",
      "CustomerId": "sample string 2",
      "DocumentType": "sample string 3",
      "DocumentTypeId": 4,
      "DocumentClassification": "sample string 5",
      "DocumentClassificationId": 6,
      "Name": "sample string 7",
      "MimeType": "sample string 8",
      "AddedBy": "sample string 9",
      "DatedAddedUtc": "2025-08-21T05:39:04.3207768+00:00",
      "UpdatedBy": "sample string 11",
      "DateUpdatedUtc": "2025-08-21T05:39:04.3207768+00:00",
      "Href": "sample string 13",
      "PreviewHref": "sample string 14"
    },
    {
      "Id": "sample string 1",
      "CustomerId": "sample string 2",
      "DocumentType": "sample string 3",
      "DocumentTypeId": 4,
      "DocumentClassification": "sample string 5",
      "DocumentClassificationId": 6,
      "Name": "sample string 7",
      "MimeType": "sample string 8",
      "AddedBy": "sample string 9",
      "DatedAddedUtc": "2025-08-21T05:39:04.3207768+00:00",
      "UpdatedBy": "sample string 11",
      "DateUpdatedUtc": "2025-08-21T05:39:04.3207768+00:00",
      "Href": "sample string 13",
      "PreviewHref": "sample string 14"
    }
  ],
  "MergedCustomers": [
    "72f55bb8-dfaa-41d1-af19-2f1ea6a8699a",
    "d62a7dd7-7964-4903-b460-b80b0e630048"
  ],
  "PrimaryName": "sample string 1",
  "Title": "sample string 2",
  "AlternateName": "sample string 3",
  "MiddleName": "sample string 4",
  "FamilyName": "sample string 5",
  "ReferralSource": "sample string 6",
  "Notes": "sample string 7",
  "UniqueIdentifier": "sample string 8",
  "Id": "189a62ab-b064-4315-b9e1-b13909a806f9",
  "CustomerTypeId": 10,
  "CustomerType": "sample string 11",
  "DateOfBirth": "2025-08-21T05:39:04.3207768+00:00",
  "PricingGroupId": 13,
  "Disabled": true,
  "DoNotContact": true,
  "Version": 16,
  "MergedIntoCustomerId": "198718f7-90ce-4134-bb1d-dce5afa68d73",
  "LastModifiedDateUtc": "2025-08-21T05:39:04.3207768+00:00"
}