POST api/v1/donoraccess/donor?token={token}

Update Donor

Request Information

URI Parameters

NameDescriptionTypeAdditional information
token

Valid donor token retrieved from token end point

string

Required

Body Parameters

Donor access object that needs to be updated in ProVision

DonorAccessDonor
NameDescriptionTypeAdditional information
SourceDescription

string

None.

DonorID

string

String length: inclusive between 0 and 20

ExternalReference

How is the donor referenced in external system?

string

String length: inclusive between 0 and 50

ExternalOrigin

string

String length: inclusive between 0 and 50

Source

string

String length: inclusive between 0 and 20

DateAdd

date

None.

DateAddUTC

string

None.

NameLast

string

String length: inclusive between 0 and 40

NameFirst

string

String length: inclusive between 0 and 30

NameMiddle

string

String length: inclusive between 0 and 30

NameTitle

string

String length: inclusive between 0 and 30

NameSuffix

string

String length: inclusive between 0 and 30

Salutation

string

String length: inclusive between 0 and 30

Company

string

String length: inclusive between 0 and 50

Birthdate

date

None.

DonorType

Collection of DonorCode

None.

DonorAddress

PostalAddress

None.

SecondaryAddresses

Collection of PostalAddress

None.

Email

string

String length: inclusive between 0 and 120

SecondaryEmails

Collection of DonorEmail

None.

Phone

string

String length: inclusive between 0 and 30

SecondaryPhone

Collection of DonorPhone

None.

DonorStop

Collection of DonorCode

None.

DonorAppeal

Collection of DonorCode

None.

DonorStatus

string

String length: inclusive between 0 and 2

LastUpdated

date

None.

LastUpdatedBy

string

String length: inclusive between 0 and 200

Created

date

None.

CreatedBy

string

String length: inclusive between 0 and 200

DonorAttributes

DonorAttribute

None.

Request Formats

application/json, text/json

Sample:
{
  "SourceDescription": "sample string 1",
  "DonorID": "sample string 2",
  "ExternalReference": "sample string 3",
  "ExternalOrigin": "sample string 4",
  "Source": "sample string 5",
  "DateAdd": "2025-09-04T15:06:49.358",
  "DateAddUTC": "sample string 7",
  "NameLast": "sample string 8",
  "NameFirst": "sample string 9",
  "NameMiddle": "sample string 10",
  "NameTitle": "sample string 11",
  "NameSuffix": "sample string 12",
  "Salutation": "sample string 13",
  "Company": "sample string 14",
  "Birthdate": "2025-09-04T15:06:49.358",
  "DonorType": [
    {
      "Code": "sample string 1"
    },
    {
      "Code": "sample string 1"
    }
  ],
  "DonorAddress": {
    "Line1": "sample string 1",
    "Line2": "sample string 2",
    "Line3": "sample string 3",
    "City": "sample string 4",
    "StatePR": "sample string 5",
    "PostalCode": "sample string 6",
    "Country": "sample string 7"
  },
  "SecondaryAddresses": [
    {
      "Line1": "sample string 1",
      "Line2": "sample string 2",
      "Line3": "sample string 3",
      "City": "sample string 4",
      "StatePR": "sample string 5",
      "PostalCode": "sample string 6",
      "Country": "sample string 7"
    },
    {
      "Line1": "sample string 1",
      "Line2": "sample string 2",
      "Line3": "sample string 3",
      "City": "sample string 4",
      "StatePR": "sample string 5",
      "PostalCode": "sample string 6",
      "Country": "sample string 7"
    }
  ],
  "Email": "sample string 15",
  "SecondaryEmails": [
    {
      "Email": "sample string 1"
    },
    {
      "Email": "sample string 1"
    }
  ],
  "Phone": "sample string 16",
  "SecondaryPhone": [
    {
      "Phone": "sample string 1"
    },
    {
      "Phone": "sample string 1"
    }
  ],
  "DonorStop": [
    {
      "Code": "sample string 1"
    },
    {
      "Code": "sample string 1"
    }
  ],
  "DonorAppeal": [
    {
      "Code": "sample string 1"
    },
    {
      "Code": "sample string 1"
    }
  ],
  "DonorStatus": "sample string 17",
  "LastUpdated": "2025-09-04T15:06:49.358",
  "LastUpdatedBy": "sample string 18",
  "Created": "2025-09-04T15:06:49.358",
  "CreatedBy": "sample string 19",
  "DonorAttributes": {
    "FundDesignation": "sample string 1"
  }
}

application/xml, text/xml

Sample:
<DonorAccessDonor xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DPCSWS.Models">
  <Birthdate>2025-09-04T15:06:49.3586443+00:00</Birthdate>
  <Company>sample string 14</Company>
  <Created>2025-09-04T15:06:49.3586443+00:00</Created>
  <CreatedBy>sample string 19</CreatedBy>
  <DateAdd>2025-09-04T15:06:49.3586443+00:00</DateAdd>
  <DateAddUTC>sample string 7</DateAddUTC>
  <DonorAddress>
    <City>sample string 4</City>
    <Country>sample string 7</Country>
    <Line1>sample string 1</Line1>
    <Line2>sample string 2</Line2>
    <Line3>sample string 3</Line3>
    <PostalCode>sample string 6</PostalCode>
    <StatePR>sample string 5</StatePR>
  </DonorAddress>
  <DonorAppeal>
    <DonorCode>
      <Code>sample string 1</Code>
    </DonorCode>
    <DonorCode>
      <Code>sample string 1</Code>
    </DonorCode>
  </DonorAppeal>
  <DonorAttributes>
    <FundDesignation>sample string 1</FundDesignation>
  </DonorAttributes>
  <DonorID>sample string 2</DonorID>
  <DonorStatus>sample string 17</DonorStatus>
  <DonorStop>
    <DonorCode>
      <Code>sample string 1</Code>
    </DonorCode>
    <DonorCode>
      <Code>sample string 1</Code>
    </DonorCode>
  </DonorStop>
  <DonorType>
    <DonorCode>
      <Code>sample string 1</Code>
    </DonorCode>
    <DonorCode>
      <Code>sample string 1</Code>
    </DonorCode>
  </DonorType>
  <Email>sample string 15</Email>
  <ExternalOrigin>sample string 4</ExternalOrigin>
  <ExternalReference>sample string 3</ExternalReference>
  <LastUpdated>2025-09-04T15:06:49.3586443+00:00</LastUpdated>
  <LastUpdatedBy>sample string 18</LastUpdatedBy>
  <NameFirst>sample string 9</NameFirst>
  <NameLast>sample string 8</NameLast>
  <NameMiddle>sample string 10</NameMiddle>
  <NameSuffix>sample string 12</NameSuffix>
  <NameTitle>sample string 11</NameTitle>
  <Phone>sample string 16</Phone>
  <Salutation>sample string 13</Salutation>
  <SecondaryAddresses>
    <PostalAddress>
      <City>sample string 4</City>
      <Country>sample string 7</Country>
      <Line1>sample string 1</Line1>
      <Line2>sample string 2</Line2>
      <Line3>sample string 3</Line3>
      <PostalCode>sample string 6</PostalCode>
      <StatePR>sample string 5</StatePR>
    </PostalAddress>
    <PostalAddress>
      <City>sample string 4</City>
      <Country>sample string 7</Country>
      <Line1>sample string 1</Line1>
      <Line2>sample string 2</Line2>
      <Line3>sample string 3</Line3>
      <PostalCode>sample string 6</PostalCode>
      <StatePR>sample string 5</StatePR>
    </PostalAddress>
  </SecondaryAddresses>
  <SecondaryEmails>
    <DonorEmail>
      <Email>sample string 1</Email>
    </DonorEmail>
    <DonorEmail>
      <Email>sample string 1</Email>
    </DonorEmail>
  </SecondaryEmails>
  <SecondaryPhone>
    <DonorPhone>
      <Phone>sample string 1</Phone>
    </DonorPhone>
    <DonorPhone>
      <Phone>sample string 1</Phone>
    </DonorPhone>
  </SecondaryPhone>
  <Source>sample string 5</Source>
  <SourceDescription>sample string 1</SourceDescription>
</DonorAccessDonor>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

IHttpActionResult

None.

Response Formats

application/json, text/json, application/xml, text/xml

Sample:

Sample not available.