regis

<back to all web services

CRMContactUpsertMultipleRequest

Requires Authentication
Required role:REGISUserRole
The following routes are available for this service:
POST/DynamicsCRM/Contact/Upsert/Multiple
<?php namespace dtos;

use DateTime;
use Exception;
use DateInterval;
use JsonSerializable;
use ServiceStack\{IReturn,IReturnVoid,IGet,IPost,IPut,IDelete,IPatch,IMeta,IHasSessionId,IHasBearerToken,IHasVersion};
use ServiceStack\{ICrud,ICreateDb,IUpdateDb,IPatchDb,IDeleteDb,ISaveDb,AuditBase,QueryDb,QueryDb2,QueryData,QueryData2,QueryResponse};
use ServiceStack\{ResponseStatus,ResponseError,EmptyResponse,IdResponse,ArrayList,KeyValuePair2,StringResponse,StringsResponse,Tuple2,Tuple3,ByteArray};
use ServiceStack\{JsonConverters,Returns,TypeContext};


class CRMContactCreateRequest implements JsonSerializable
{
    public function __construct(
        /** @var int|null */
        public ?int $regent_id=null,
        /** @var string|null */
        public ?string $first_name=null,
        /** @var string|null */
        public ?string $last_name=null,
        /** @var string|null */
        public ?string $middle_name=null,
        /** @var string|null */
        public ?string $preferred_name=null,
        /** @var string|null */
        public ?string $prefix=null,
        /** @var string|null */
        public ?string $addressee=null,
        /** @var string|null */
        public ?string $primary_salutation=null,
        /** @var string|null */
        public ?string $former_name=null,
        /** @var string|null */
        public ?string $spouse_name=null,
        /** @var bool|null */
        public ?bool $spouse_is_main_contact=null,
        /** @var string|null */
        public ?string $addr1=null,
        /** @var string|null */
        public ?string $addr2=null,
        /** @var string|null */
        public ?string $city=null,
        /** @var string|null */
        public ?string $state=null,
        /** @var string|null */
        public ?string $country=null,
        /** @var string|null */
        public ?string $code=null,
        /** @var DateTime|null */
        public ?DateTime $dob=null,
        /** @var DateTime|null */
        public ?DateTime $deceased_date=null,
        /** @var string|null */
        public ?string $citizenship=null,
        /** @var string|null */
        public ?string $citizenship_other=null,
        /** @var string|null */
        public ?string $permanent_resident=null,
        /** @var string|null */
        public ?string $denomination=null,
        /** @var string|null */
        public ?string $connection_to_regent=null,
        /** @var string|null */
        public ?string $student_segment=null,
        /** @var string|null */
        public ?string $reason_added=null,
        /** @var string|null */
        public ?string $gender=null,
        /** @var string|null */
        public ?string $marital_status=null,
        /** @var bool|null */
        public ?bool $financial_aid_received=null,
        /** @var bool|null */
        public ?bool $is_applicant=null,
        /** @var string|null */
        public ?string $solicitation_method=null,
        /** @var string|null */
        public ?string $solicitation_exceptions=null,
        /** @var bool|null */
        public ?bool $campaign_monitor_optin=null,
        /** @var bool|null */
        public ?bool $campaign_monitor_suppressed=null,
        /** @var string|null */
        public ?string $campaign_monitor_lists=null,
        /** @var string|null */
        public ?string $email=null,
        /** @var string|null */
        public ?string $email_secondary=null,
        /** @var string|null */
        public ?string $phone_home=null,
        /** @var string|null */
        public ?string $phone_bus=null,
        /** @var string|null */
        public ?string $phone_cell=null,
        /** @var bool|null */
        public ?bool $no_mail=null,
        /** @var bool|null */
        public ?bool $no_email=null,
        /** @var bool|null */
        public ?bool $no_bulk_email=null,
        /** @var bool|null */
        public ?bool $no_phone=null,
        /** @var bool|null */
        public ?bool $no_marketing_materials=null,
        /** @var bool|null */
        public ?bool $prefers_email=null,
        /** @var bool|null */
        public ?bool $prefers_phone=null,
        /** @var DateTime|null */
        public ?DateTime $last_credit_class=null,
        /** @var DateTime|null */
        public ?DateTime $last_audit_class=null,
        /** @var DateTime|null */
        public ?DateTime $last_oncampus_class=null,
        /** @var DateTime|null */
        public ?DateTime $last_distance_education_class=null,
        /** @var DateTime|null */
        public ?DateTime $last_evening_weekend_class=null,
        /** @var DateTime|null */
        public ?DateTime $last_summer_class=null,
        /** @var DateTime|null */
        public ?DateTime $last_marketplace_class=null,
        /** @var DateTime|null */
        public ?DateTime $last_anglican_studies_class=null,
        /** @var string|null */
        public ?string $image_base64=null,
        /** @var string|null */
        public ?string $owning_username=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['regent_id'])) $this->regent_id = $o['regent_id'];
        if (isset($o['first_name'])) $this->first_name = $o['first_name'];
        if (isset($o['last_name'])) $this->last_name = $o['last_name'];
        if (isset($o['middle_name'])) $this->middle_name = $o['middle_name'];
        if (isset($o['preferred_name'])) $this->preferred_name = $o['preferred_name'];
        if (isset($o['prefix'])) $this->prefix = $o['prefix'];
        if (isset($o['addressee'])) $this->addressee = $o['addressee'];
        if (isset($o['primary_salutation'])) $this->primary_salutation = $o['primary_salutation'];
        if (isset($o['former_name'])) $this->former_name = $o['former_name'];
        if (isset($o['spouse_name'])) $this->spouse_name = $o['spouse_name'];
        if (isset($o['spouse_is_main_contact'])) $this->spouse_is_main_contact = $o['spouse_is_main_contact'];
        if (isset($o['addr1'])) $this->addr1 = $o['addr1'];
        if (isset($o['addr2'])) $this->addr2 = $o['addr2'];
        if (isset($o['city'])) $this->city = $o['city'];
        if (isset($o['state'])) $this->state = $o['state'];
        if (isset($o['country'])) $this->country = $o['country'];
        if (isset($o['code'])) $this->code = $o['code'];
        if (isset($o['dob'])) $this->dob = JsonConverters::from('DateTime', $o['dob']);
        if (isset($o['deceased_date'])) $this->deceased_date = JsonConverters::from('DateTime', $o['deceased_date']);
        if (isset($o['citizenship'])) $this->citizenship = $o['citizenship'];
        if (isset($o['citizenship_other'])) $this->citizenship_other = $o['citizenship_other'];
        if (isset($o['permanent_resident'])) $this->permanent_resident = $o['permanent_resident'];
        if (isset($o['denomination'])) $this->denomination = $o['denomination'];
        if (isset($o['connection_to_regent'])) $this->connection_to_regent = $o['connection_to_regent'];
        if (isset($o['student_segment'])) $this->student_segment = $o['student_segment'];
        if (isset($o['reason_added'])) $this->reason_added = $o['reason_added'];
        if (isset($o['gender'])) $this->gender = $o['gender'];
        if (isset($o['marital_status'])) $this->marital_status = $o['marital_status'];
        if (isset($o['financial_aid_received'])) $this->financial_aid_received = $o['financial_aid_received'];
        if (isset($o['is_applicant'])) $this->is_applicant = $o['is_applicant'];
        if (isset($o['solicitation_method'])) $this->solicitation_method = $o['solicitation_method'];
        if (isset($o['solicitation_exceptions'])) $this->solicitation_exceptions = $o['solicitation_exceptions'];
        if (isset($o['campaign_monitor_optin'])) $this->campaign_monitor_optin = $o['campaign_monitor_optin'];
        if (isset($o['campaign_monitor_suppressed'])) $this->campaign_monitor_suppressed = $o['campaign_monitor_suppressed'];
        if (isset($o['campaign_monitor_lists'])) $this->campaign_monitor_lists = $o['campaign_monitor_lists'];
        if (isset($o['email'])) $this->email = $o['email'];
        if (isset($o['email_secondary'])) $this->email_secondary = $o['email_secondary'];
        if (isset($o['phone_home'])) $this->phone_home = $o['phone_home'];
        if (isset($o['phone_bus'])) $this->phone_bus = $o['phone_bus'];
        if (isset($o['phone_cell'])) $this->phone_cell = $o['phone_cell'];
        if (isset($o['no_mail'])) $this->no_mail = $o['no_mail'];
        if (isset($o['no_email'])) $this->no_email = $o['no_email'];
        if (isset($o['no_bulk_email'])) $this->no_bulk_email = $o['no_bulk_email'];
        if (isset($o['no_phone'])) $this->no_phone = $o['no_phone'];
        if (isset($o['no_marketing_materials'])) $this->no_marketing_materials = $o['no_marketing_materials'];
        if (isset($o['prefers_email'])) $this->prefers_email = $o['prefers_email'];
        if (isset($o['prefers_phone'])) $this->prefers_phone = $o['prefers_phone'];
        if (isset($o['last_credit_class'])) $this->last_credit_class = JsonConverters::from('DateTime', $o['last_credit_class']);
        if (isset($o['last_audit_class'])) $this->last_audit_class = JsonConverters::from('DateTime', $o['last_audit_class']);
        if (isset($o['last_oncampus_class'])) $this->last_oncampus_class = JsonConverters::from('DateTime', $o['last_oncampus_class']);
        if (isset($o['last_distance_education_class'])) $this->last_distance_education_class = JsonConverters::from('DateTime', $o['last_distance_education_class']);
        if (isset($o['last_evening_weekend_class'])) $this->last_evening_weekend_class = JsonConverters::from('DateTime', $o['last_evening_weekend_class']);
        if (isset($o['last_summer_class'])) $this->last_summer_class = JsonConverters::from('DateTime', $o['last_summer_class']);
        if (isset($o['last_marketplace_class'])) $this->last_marketplace_class = JsonConverters::from('DateTime', $o['last_marketplace_class']);
        if (isset($o['last_anglican_studies_class'])) $this->last_anglican_studies_class = JsonConverters::from('DateTime', $o['last_anglican_studies_class']);
        if (isset($o['image_base64'])) $this->image_base64 = $o['image_base64'];
        if (isset($o['owning_username'])) $this->owning_username = $o['owning_username'];
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->regent_id)) $o['regent_id'] = $this->regent_id;
        if (isset($this->first_name)) $o['first_name'] = $this->first_name;
        if (isset($this->last_name)) $o['last_name'] = $this->last_name;
        if (isset($this->middle_name)) $o['middle_name'] = $this->middle_name;
        if (isset($this->preferred_name)) $o['preferred_name'] = $this->preferred_name;
        if (isset($this->prefix)) $o['prefix'] = $this->prefix;
        if (isset($this->addressee)) $o['addressee'] = $this->addressee;
        if (isset($this->primary_salutation)) $o['primary_salutation'] = $this->primary_salutation;
        if (isset($this->former_name)) $o['former_name'] = $this->former_name;
        if (isset($this->spouse_name)) $o['spouse_name'] = $this->spouse_name;
        if (isset($this->spouse_is_main_contact)) $o['spouse_is_main_contact'] = $this->spouse_is_main_contact;
        if (isset($this->addr1)) $o['addr1'] = $this->addr1;
        if (isset($this->addr2)) $o['addr2'] = $this->addr2;
        if (isset($this->city)) $o['city'] = $this->city;
        if (isset($this->state)) $o['state'] = $this->state;
        if (isset($this->country)) $o['country'] = $this->country;
        if (isset($this->code)) $o['code'] = $this->code;
        if (isset($this->dob)) $o['dob'] = JsonConverters::to('DateTime', $this->dob);
        if (isset($this->deceased_date)) $o['deceased_date'] = JsonConverters::to('DateTime', $this->deceased_date);
        if (isset($this->citizenship)) $o['citizenship'] = $this->citizenship;
        if (isset($this->citizenship_other)) $o['citizenship_other'] = $this->citizenship_other;
        if (isset($this->permanent_resident)) $o['permanent_resident'] = $this->permanent_resident;
        if (isset($this->denomination)) $o['denomination'] = $this->denomination;
        if (isset($this->connection_to_regent)) $o['connection_to_regent'] = $this->connection_to_regent;
        if (isset($this->student_segment)) $o['student_segment'] = $this->student_segment;
        if (isset($this->reason_added)) $o['reason_added'] = $this->reason_added;
        if (isset($this->gender)) $o['gender'] = $this->gender;
        if (isset($this->marital_status)) $o['marital_status'] = $this->marital_status;
        if (isset($this->financial_aid_received)) $o['financial_aid_received'] = $this->financial_aid_received;
        if (isset($this->is_applicant)) $o['is_applicant'] = $this->is_applicant;
        if (isset($this->solicitation_method)) $o['solicitation_method'] = $this->solicitation_method;
        if (isset($this->solicitation_exceptions)) $o['solicitation_exceptions'] = $this->solicitation_exceptions;
        if (isset($this->campaign_monitor_optin)) $o['campaign_monitor_optin'] = $this->campaign_monitor_optin;
        if (isset($this->campaign_monitor_suppressed)) $o['campaign_monitor_suppressed'] = $this->campaign_monitor_suppressed;
        if (isset($this->campaign_monitor_lists)) $o['campaign_monitor_lists'] = $this->campaign_monitor_lists;
        if (isset($this->email)) $o['email'] = $this->email;
        if (isset($this->email_secondary)) $o['email_secondary'] = $this->email_secondary;
        if (isset($this->phone_home)) $o['phone_home'] = $this->phone_home;
        if (isset($this->phone_bus)) $o['phone_bus'] = $this->phone_bus;
        if (isset($this->phone_cell)) $o['phone_cell'] = $this->phone_cell;
        if (isset($this->no_mail)) $o['no_mail'] = $this->no_mail;
        if (isset($this->no_email)) $o['no_email'] = $this->no_email;
        if (isset($this->no_bulk_email)) $o['no_bulk_email'] = $this->no_bulk_email;
        if (isset($this->no_phone)) $o['no_phone'] = $this->no_phone;
        if (isset($this->no_marketing_materials)) $o['no_marketing_materials'] = $this->no_marketing_materials;
        if (isset($this->prefers_email)) $o['prefers_email'] = $this->prefers_email;
        if (isset($this->prefers_phone)) $o['prefers_phone'] = $this->prefers_phone;
        if (isset($this->last_credit_class)) $o['last_credit_class'] = JsonConverters::to('DateTime', $this->last_credit_class);
        if (isset($this->last_audit_class)) $o['last_audit_class'] = JsonConverters::to('DateTime', $this->last_audit_class);
        if (isset($this->last_oncampus_class)) $o['last_oncampus_class'] = JsonConverters::to('DateTime', $this->last_oncampus_class);
        if (isset($this->last_distance_education_class)) $o['last_distance_education_class'] = JsonConverters::to('DateTime', $this->last_distance_education_class);
        if (isset($this->last_evening_weekend_class)) $o['last_evening_weekend_class'] = JsonConverters::to('DateTime', $this->last_evening_weekend_class);
        if (isset($this->last_summer_class)) $o['last_summer_class'] = JsonConverters::to('DateTime', $this->last_summer_class);
        if (isset($this->last_marketplace_class)) $o['last_marketplace_class'] = JsonConverters::to('DateTime', $this->last_marketplace_class);
        if (isset($this->last_anglican_studies_class)) $o['last_anglican_studies_class'] = JsonConverters::to('DateTime', $this->last_anglican_studies_class);
        if (isset($this->image_base64)) $o['image_base64'] = $this->image_base64;
        if (isset($this->owning_username)) $o['owning_username'] = $this->owning_username;
        return empty($o) ? new class(){} : $o;
    }
}

class CRMContactUpsertMultipleRequest implements JsonSerializable
{
    public function __construct(
        /** @var array<CRMContactCreateRequest>|null */
        public ?array $contacts=null
    ) {
    }

    /** @throws Exception */
    public function fromMap($o): void {
        if (isset($o['contacts'])) $this->contacts = JsonConverters::fromArray('CRMContactCreateRequest', $o['contacts']);
    }
    
    /** @throws Exception */
    public function jsonSerialize(): mixed
    {
        $o = [];
        if (isset($this->contacts)) $o['contacts'] = JsonConverters::toArray('CRMContactCreateRequest', $this->contacts);
        return empty($o) ? new class(){} : $o;
    }
}

PHP CRMContactUpsertMultipleRequest DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /DynamicsCRM/Contact/Upsert/Multiple HTTP/1.1 
Host: data.regent-college.edu 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<CRMContactUpsertMultipleRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/regis.DynamicsCRM.Requests">
  <contacts>
    <CRMContactCreateRequest>
      <addr1>String</addr1>
      <addr2>String</addr2>
      <addressee>String</addressee>
      <campaign_monitor_lists>String</campaign_monitor_lists>
      <campaign_monitor_optin>false</campaign_monitor_optin>
      <campaign_monitor_suppressed>false</campaign_monitor_suppressed>
      <citizenship>String</citizenship>
      <citizenship_other>String</citizenship_other>
      <city>String</city>
      <code>String</code>
      <connection_to_regent>String</connection_to_regent>
      <country>String</country>
      <deceased_date>0001-01-01T00:00:00</deceased_date>
      <denomination>String</denomination>
      <dob>0001-01-01T00:00:00</dob>
      <email>String</email>
      <email_secondary>String</email_secondary>
      <financial_aid_received>false</financial_aid_received>
      <first_name>String</first_name>
      <former_name>String</former_name>
      <gender>String</gender>
      <image_base64>String</image_base64>
      <is_applicant>false</is_applicant>
      <last_anglican_studies_class>0001-01-01T00:00:00</last_anglican_studies_class>
      <last_audit_class>0001-01-01T00:00:00</last_audit_class>
      <last_credit_class>0001-01-01T00:00:00</last_credit_class>
      <last_distance_education_class>0001-01-01T00:00:00</last_distance_education_class>
      <last_evening_weekend_class>0001-01-01T00:00:00</last_evening_weekend_class>
      <last_marketplace_class>0001-01-01T00:00:00</last_marketplace_class>
      <last_name>String</last_name>
      <last_oncampus_class>0001-01-01T00:00:00</last_oncampus_class>
      <last_summer_class>0001-01-01T00:00:00</last_summer_class>
      <marital_status>String</marital_status>
      <middle_name>String</middle_name>
      <no_bulk_email>false</no_bulk_email>
      <no_email>false</no_email>
      <no_mail>false</no_mail>
      <no_marketing_materials>false</no_marketing_materials>
      <no_phone>false</no_phone>
      <owning_username>String</owning_username>
      <permanent_resident>String</permanent_resident>
      <phone_bus>String</phone_bus>
      <phone_cell>String</phone_cell>
      <phone_home>String</phone_home>
      <preferred_name>String</preferred_name>
      <prefers_email>false</prefers_email>
      <prefers_phone>false</prefers_phone>
      <prefix>String</prefix>
      <primary_salutation>String</primary_salutation>
      <reason_added>String</reason_added>
      <regent_id>0</regent_id>
      <solicitation_exceptions>String</solicitation_exceptions>
      <solicitation_method>String</solicitation_method>
      <spouse_is_main_contact>false</spouse_is_main_contact>
      <spouse_name>String</spouse_name>
      <state>String</state>
      <student_segment>String</student_segment>
    </CRMContactCreateRequest>
  </contacts>
</CRMContactUpsertMultipleRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ResponseStatus xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.servicestack.net/types">
  <ErrorCode>String</ErrorCode>
  <Message>String</Message>
  <StackTrace>String</StackTrace>
  <Errors>
    <ResponseError>
      <ErrorCode>String</ErrorCode>
      <FieldName>String</FieldName>
      <Message>String</Message>
      <Meta xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:KeyValueOfstringstring>
          <d4p1:Key>String</d4p1:Key>
          <d4p1:Value>String</d4p1:Value>
        </d4p1:KeyValueOfstringstring>
      </Meta>
    </ResponseError>
  </Errors>
  <Meta xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringstring>
      <d2p1:Key>String</d2p1:Key>
      <d2p1:Value>String</d2p1:Value>
    </d2p1:KeyValueOfstringstring>
  </Meta>
</ResponseStatus>