Requires any of the roles: | SystemAdministrator, Manager, Customer |
POST | /customers |
---|
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
AccountId | body | string | No | The account ID to associate this customer with |
Name | body | string | No | The name of the customer |
ParentCustomerId | body | string | No | The parent customer for this customer |
ReferenceId | body | string | No | The reference ID for this customer (e.g. in a third party system) |
Data | body | Struct | No | Data values for this customer |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
BoolValue | form | bool? | No | |
StringValue | form | string | No | |
NumberValue | form | double? | No | |
ListValue | form | List<Struct> | No | |
StructValue | form | Struct | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
AccountId | form | string | No | The ID of the account associated with this customer |
ParentCustomerId | form | string | No | The parent customer ID for this customer |
Breadcrumb | form | List<CustomerBreadcrumb> | No | The breadcrumb to this customer |
AccountName | form | string | No | The name of the account associated with this customer |
IsStaging | form | bool | No | Is this customer staging or production? |
Name | form | string | No | The name of the company |
ReferenceId | form | string | No | The reference ID for this company |
Data | form | Struct | No | This customer's data values |
Tags | form | List<Tag> | No | The list of tags for this customer |
Schedule | form | Schedule | No | This customer's schedule |
IntegrationData | form | EntityIntegrationData | No | Integration data for this customer |
OverrideBillingSettings | form | bool | No | Override this customer's billing settings? Otherwise inherits from parent |
BillingSettings | form | BillingSettings | No | Billing settings for this customer |
OverrideAppSettings | form | bool | No | Should this customer override the parent customer's app settings |
AppSettings | form | AppSettings | No | App / Portal settings for this customer |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | The ID of the object |
DateCreated | form | string | No | The date the object was created |
DateLastModified | form | string | No | The date the object was last modified |
CreatedBy | form | string | No | The user that created this object |
LastModifiedBy | form | string | No | The user that last modified this object |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | |
Name | form | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | |
Name | form | string | No | |
Color | form | TagColors | No |
Magenta | |
Red | |
Volcano | |
Orange | |
Gold | |
Lime | |
Green | |
Cyan | |
Blue | |
GeekBlue | |
Purple |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
TimeZoneId | form | string | No | |
Inherit | form | bool | No | |
ForceClosed | form | bool | No | |
Rules | form | List<SchedulingRule> | No | |
DefaultState | form | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | string | No | |
Name | form | string | No | |
Priority | form | int | No | |
State | form | string | No | |
Source | form | string | No | |
Condition | form | string | No | |
SimpleRuleType | form | SimpleSchedulingRuleTypes | No | |
CustomerState | form | string | No | |
FlowId | form | string | No | |
FlowParams | form | Struct | No | |
IsAllDay | form | bool | No | |
StartDate | form | string | No | |
StartTime | form | string | No | |
EndTime | form | string | No | |
BySetPosition | form | List<int> | No | |
ByMonth | form | List<int> | No | |
ByWeekNo | form | List<int> | No | |
ByYearDay | form | List<int> | No | |
ByMonthDay | form | List<int> | No | |
ByDay | form | List<ScheduleDay> | No | |
ByHour | form | List<int> | No | |
ByMinute | form | List<int> | No | |
Interval | form | int | No | |
Count | form | int | No | |
UntilDate | form | string | No | |
Frequency | form | SchedulingRuleFrequency | No |
Always | |
CustomerState | |
Time |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Offset | form | int | No | |
DayOfWeek | form | DayOfWeek | No |
None | |
Secondly | |
Minutely | |
Hourly | |
Daily | |
Weekly | |
Monthly | |
Yearly |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
ThirdPartyId | form | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Base | form | BillingItem | No | |
LocalNumbers | form | BillingItem | No | |
TollFreeNumbers | form | BillingItem | No | |
InboundVoiceCalls | form | BillingItem | No | |
OutboundVoiceCalls | form | BillingItem | No | |
InboundFaxes | form | BillingItem | No | |
OutboundFaxes | form | BillingItem | No | |
InboundSmsMessages | form | BillingItem | No | |
OutboundSmsMessages | form | BillingItem | No | |
AIInsights | form | BillingItem | No | |
AILiveMinutes | form | BillingItem | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
BaseCost | form | double | No | |
RawUnitMultiplier | form | double | No | |
UnitCost | form | double | No | |
Allowance | form | int | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
EnablePhoneNumberManagement | form | bool | No | |
EnableDeviceManagement | form | bool | No | |
EnableDialer | form | bool | No | |
EnableCallHistory | form | bool | No | |
EnableAssistants | form | bool | No | |
ShowFileNameInMessageCenter | form | bool | No | |
ChakraTheme | form | string | No | |
CustomCss | form | string | No | |
PageTitle | form | string | No | |
StringMappings | form | string | No | |
LogoutUrl | form | string | No | |
PortMyNumberUrl | form | string | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /customers HTTP/1.1
Host: team.evovoice.io
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<NewCustomer xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Customers">
<AccountId>String</AccountId>
<Data xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
<Name>String</Name>
<ParentCustomerId>String</ParentCustomerId>
<ReferenceId>String</ReferenceId>
</NewCustomer>
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <CustomerInfo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Customers"> <CreatedBy xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</CreatedBy> <DateCreated xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</DateCreated> <DateLastModified xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</DateLastModified> <Id xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</Id> <LastModifiedBy xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</LastModifiedBy> <AccountId>String</AccountId> <AccountName>String</AccountName> <AppSettings> <ChakraTheme>String</ChakraTheme> <CustomCss>String</CustomCss> <EnableAssistants>false</EnableAssistants> <EnableCallHistory>false</EnableCallHistory> <EnableDeviceManagement>false</EnableDeviceManagement> <EnableDialer>false</EnableDialer> <EnablePhoneNumberManagement>false</EnablePhoneNumberManagement> <LogoutUrl>String</LogoutUrl> <PageTitle>String</PageTitle> <PortMyNumberUrl>String</PortMyNumberUrl> <ShowFileNameInMessageCenter>false</ShowFileNameInMessageCenter> <StringMappings>String</StringMappings> </AppSettings> <BillingSettings xmlns:d2p1="http://schemas.datacontract.org/2004/07/Voice.Api.Accounts"> <d2p1:AIInsights> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:AIInsights> <d2p1:AILiveMinutes> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:AILiveMinutes> <d2p1:Base> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:Base> <d2p1:InboundFaxes> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:InboundFaxes> <d2p1:InboundSmsMessages> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:InboundSmsMessages> <d2p1:InboundVoiceCalls> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:InboundVoiceCalls> <d2p1:LocalNumbers> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:LocalNumbers> <d2p1:OutboundFaxes> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:OutboundFaxes> <d2p1:OutboundSmsMessages> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:OutboundSmsMessages> <d2p1:OutboundVoiceCalls> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:OutboundVoiceCalls> <d2p1:TollFreeNumbers> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:TollFreeNumbers> </BillingSettings> <Breadcrumb> <CustomerBreadcrumb> <Id>String</Id> <Name>String</Name> </CustomerBreadcrumb> </Breadcrumb> <Data xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" /> <IntegrationData xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d2p1:KeyValueOfstringIntegrationDataY_SkqLnhh> <d2p1:Key>String</d2p1:Key> <d2p1:Value xmlns:d4p1="http://schemas.datacontract.org/2004/07/Voice.Api.Integrations"> <d4p1:ThirdPartyId>String</d4p1:ThirdPartyId> </d2p1:Value> </d2p1:KeyValueOfstringIntegrationDataY_SkqLnhh> </IntegrationData> <IsStaging>false</IsStaging> <Name>String</Name> <OverrideAppSettings>false</OverrideAppSettings> <OverrideBillingSettings>false</OverrideBillingSettings> <ParentCustomerId>String</ParentCustomerId> <ReferenceId>String</ReferenceId> <Schedule xmlns:d2p1="http://schemas.datacontract.org/2004/07/Voice.Api.Scheduling"> <d2p1:DefaultState>String</d2p1:DefaultState> <d2p1:ForceClosed>false</d2p1:ForceClosed> <d2p1:Inherit>false</d2p1:Inherit> <d2p1:Rules> <d2p1:SchedulingRule> <d2p1:ByDay> <d2p1:ScheduleDay> <d2p1:DayOfWeek>Sunday</d2p1:DayOfWeek> <d2p1:Offset>0</d2p1:Offset> </d2p1:ScheduleDay> </d2p1:ByDay> <d2p1:ByHour xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:int>0</d5p1:int> </d2p1:ByHour> <d2p1:ByMinute xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:int>0</d5p1:int> </d2p1:ByMinute> <d2p1:ByMonth xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:int>0</d5p1:int> </d2p1:ByMonth> <d2p1:ByMonthDay xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:int>0</d5p1:int> </d2p1:ByMonthDay> <d2p1:BySetPosition xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:int>0</d5p1:int> </d2p1:BySetPosition> <d2p1:ByWeekNo xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:int>0</d5p1:int> </d2p1:ByWeekNo> <d2p1:ByYearDay xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:int>0</d5p1:int> </d2p1:ByYearDay> <d2p1:Condition>String</d2p1:Condition> <d2p1:Count>0</d2p1:Count> <d2p1:CustomerState>String</d2p1:CustomerState> <d2p1:EndTime>String</d2p1:EndTime> <d2p1:FlowId>String</d2p1:FlowId> <d2p1:FlowParams xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" /> <d2p1:Frequency>None</d2p1:Frequency> <d2p1:Id>String</d2p1:Id> <d2p1:Interval>0</d2p1:Interval> <d2p1:IsAllDay>false</d2p1:IsAllDay> <d2p1:Name>String</d2p1:Name> <d2p1:Priority>0</d2p1:Priority> <d2p1:SimpleRuleType>Always</d2p1:SimpleRuleType> <d2p1:Source>String</d2p1:Source> <d2p1:StartDate>String</d2p1:StartDate> <d2p1:StartTime>String</d2p1:StartTime> <d2p1:State>String</d2p1:State> <d2p1:UntilDate>String</d2p1:UntilDate> </d2p1:SchedulingRule> </d2p1:Rules> <d2p1:TimeZoneId>String</d2p1:TimeZoneId> </Schedule> <Tags xmlns:d2p1="http://schemas.datacontract.org/2004/07/Voice.Api.Settings"> <d2p1:Tag> <d2p1:Color>Magenta</d2p1:Color> <d2p1:Id>String</d2p1:Id> <d2p1:Name>String</d2p1:Name> </d2p1:Tag> </Tags> </CustomerInfo>