Logo
Submit a request
Follow

Customers

Adding a Customer

URL

https://app.bluefolder.com/api/1.0/customers/add.aspx

Request

<request>
    <customerAdd>
        <customerName></customerName>
        <customerType></customerType>
        <description></description>
        <websiteURL></websiteURL>
        <industryType></industryType>
        <notes></notes>
        <defaultLaborRateID></defaultLaborRateID>
        <defaultTaxCodeID></defaultTaxCodeID>
        <inactive></inactive>
        <taxExempt></taxExempt>
        <primaryContact>
            <firstName></firstName>
            <lastName></lastName>
            <email></email>
            <jobTitle></jobTitle>
            <notes></notes>
            <phone></phone>
            <phoneFax></phoneFax>
            <phoneHome></phoneHome>
            <phoneMobile></phoneMobile>
            <phoneOther></phoneOther>
            <title></title>
        </primaryContact>
        <primaryLocation>
            <locationName></locationName>
            <addressCity></addressCity>
            <addressCountry></addressCountry>
            <addressPostalCode></addressPostalCode>
            <addressState></addressState>
            <addressStreet></addressStreet>
            <locationNotes></locationNotes>
            <serviceManagerID></serviceManagerID>
            <technicianID></technicianID>
            <zone></zone>
        </primaryLocation>
        <customFields>
            <customField name="field_name1"></customField>
            <customField name="field_name2"></customField>
        </customFields>
        <accountManagerID></accountManagerID>
        <serviceManagerID></serviceManagerID>
        <technicianID></technicianID>
        <externalID></externalID>
    </customerAdd>
</request>
            
  • customerName - (required) string (100 char limit)
  • customerType - string (50 char limit)
  • description - string (250 char limit)
  • websiteURL - string (255 char limit)
  • industryType - string (50 char limit)
  • notes - string (no char limit)
  • defaultLaborRateID - numeric, must match an existing labor rate ID from your item list
  • defaultTaxCodeID - numeric, must match an existing tax code ID from your tax codes list
  • inactive - boolean
  • taxExempt - boolean
  • primaryContact
    • firstName - (required) string (25 char limit)
    • lastName - (required) string (25 char limit)
    • email - string (100 char limit)
    • jobTitle - string (50 char limit)
    • notes - string (1000 char limit)
    • phone - string (30 char limit)
    • phoneFax - string (30 char limit)
    • phoneHome - string (30 char limit)
    • phoneMobile - string (30 char limit)
    • phoneOther - string (30 char limit)
    • title - string (10 char limit)
  • primaryLocation
    • locationName - string (50 char limit)
    • addressCity - string (25 char limit)
    • addressCountry - string (25 char limit)
    • addressPostalCode - string (10 char limit)
    • addressState - string (25 char limit)
    • addressStreet - string (250 char limit)
    • locationNotes - string (1000 char limit)
    • serviceManagerID - numeric, must match an existing User ID from your user list
    • technicianID - numeric, must match an existing User ID from your user list
    • zone - string (25 char limit)
  • customFields
    • customField - the "name" attribute must specify the exact name of a custom field in your account. The actual value included between the opening and closing "customField" element tags should be a string value, regardless of the custom field's "data type".
  • accountManagerID - numeric, must match an existing User ID from your user list
  • serviceManagerID - numeric, must match an existing User ID from your user list
  • technicianID - numeric, must match an existing User ID from your user list
  • externalID - string, external identifier that can be used to retrieve or track a customer

Response

<response status="ok">
    <customerID>xxxxxx</customerID>
</response>
            

Editing a Customer

URL

https://app.bluefolder.com/api/1.0/customers/edit.aspx

Request

<request>
    <customerEdit>
        <customerID></customerID>
        <customerName></customerName>
        <customerType></customerType>
        <description></description>
        <websiteURL></websiteURL>
        <industryType></industryType>
        <notes></notes>
        <defaultLaborRateID></defaultLaborRateID>
        <defaultTaxCodeID></defaultTaxCodeID>
        <inactive></inactive>
        <taxExempt></taxExempt>
        <customFields>
            <customField name="field_name1"></customField>
            <customField name="field_name2"></customField>
        </customFields>
        <accountManagerID></accountManagerID>
        <serviceManagerID></serviceManagerID>
        <technicianID></technicianID>
        <externalID></externalID>
    </customerAdd>
</request>
            
  • customerID - (required, if externalID not provided) numeric, the ID of the customer to be edited
  • customerName - string (100 char limit)
  • customerType - string (50 char limit)
  • description - string (250 char limit)
  • websiteURL - string (255 char limit)
  • industryType - string (50 char limit)
  • notes - string (no char limit)
  • defaultLaborRateID - numeric, must match an existing labor rate ID from your item list
  • defaultTaxCodeID - numeric, must match an existing tax code ID from your tax codes list
  • inactive - boolean
  • taxExempt - boolean
  • customFields
    • customField - the "name" attribute must specify the exact name of a custom field in your account. The actual value included between the opening and closing "customField" element tags should be a string value, regardless of the custom field's "data type".
  • accountManagerID - numeric, must match an existing User ID from your user list
  • serviceManagerID - numeric, must match an existing User ID from your user list
  • technicianID - numeric, must match an existing User ID from your user list
  • externalID - (required, if customerID not provided) string, external identifier that can be used to retrieve or track a customer

Response

<response status="ok">
    <customerID>xxxxxx</customerID>
    <externalID></externalID>
</response>
            

Retrieving a Single Customer

URL

https://app.bluefolder.com/api/1.0/customers/get.aspx

Request

<request>
    <customerID>xxxxxx</customerID>
    <externalID></externalID>
</request>
            
  • customerID - (required, if externalID not provided) numeric, the ID of the customer to be edited
  • externalID - (required, if customerID not provided) string, external identifier that can be used to retrieve or track a customer

Response

<response status="ok">
    <customer>
      <accountManagerID></accountManagerID>
      <billToAddressID></billToAddressID>
      <billToAddressName></billToAddressName>
      <billToCity></billToCity>
      <billToCountry></billToCountry>
      <billToCustomerID></billToCustomerID>
      <billToCustomerName></billToCustomerName>
      <billToPostalCode></billToPostalCode>
      <billToState></billToState>
      <billToStreetAddress></billToStreetAddress>
      <billToType></billToType>
      <customerID></customerID>
      <customerName>Amenity Arbor</customerName>
      <customerType></customerType>
      <dateTimeCreated></dateTimeCreated>
      <defaultLaborTypeID></defaultLaborTypeID>
      <defaultTaxCodeID></defaultTaxCodeID>
      <description>&lt;&gt;</description>
      <inactive></inactive>
      <industryType></industryType>
      <notes></notes>
      <serviceManagerID></serviceManagerID>
      <taxExempt></taxExempt>
      <technicianID></technicianID>
      <website></website>
      <externalID></externalID>
      <customFields>
        <customField>
          <name></name>
          <value></value>
        </customField>
      </customFields>
      <contacts>
        <contact>
          <customerID></customerID>
          <contactID></contactID>
          <displayName></displayName>
          <email></email>
          <firstName></firstName>
          <fullName></fullName>
          <isPrimary></isPrimary>
          <jobTitle></jobTitle>
          <lastName></lastName>
          <locationID></locationID>
          <middleName></middleName>
          <notes></notes>
          <phone></phone>
          <phoneFax></phoneFax>
          <phoneHome></phoneHome>
          <phoneMobile></phoneMobile>
          <phoneOther></phoneOther>
          <portalAccessGranted></portalAccessGranted>
          <portalLastLogin></portalLastLogin>
          <portalLoginCount></portalLoginCount>
          <portalUsername></portalUsername>
          <title></title>
        </contact>
      </contacts>
      <locations>
        <location>
          <addressCity></addressCity>
          <addressCountry></addressCountry>
          <addressPostalCode></addressPostalCode>
          <addressState></addressState>
          <addressStreet></addressStreet>
          <customerID></customerID>
          <isPrimary></isPrimary>
          <locationID></locationID>
          <locationName></locationName>
          <notes></notes>
          <phone></phone>
          <serviceManagerID></serviceManagerID>
          <technicianID></technicianID>
          <zone></zone>
        </location>
      </locations>
      <comments>
        <comment>
          <comment></comment>
          <createdByUserID></createdByUserID>
          <customerID></customerID>
          <dateTimeCreated></dateTimeCreated>
          <ID></ID>
        </comment>
      </comments>
      <equipment>
        <equipmentItem>
          <createdByUserID></createdByUserID>
          <customerID></customerID>
          <dateTimeCreated></dateTimeCreated>
          <equipName></equipName>
          <equipType></equipType>
          <id></id>
          <locationID></locationID>
          <mfrName></mfrName>
          <modelNo></modelNo>
          <nextServiceDate></nextServiceDate>
          <notes></notes>
          <purchaseDate></purchaseDate>
          <refNo></refNo>
          <serialNo></serialNo>
          <serviceInterval></serviceInterval>
          <serviceIntervalUnit></serviceIntervalUnit>
          <wherePurchased></wherePurchased>
        </equipmentItem>
      </equipment>
    </customer>
</response>
            

Retrieving a List of Customers

URL

https://app.bluefolder.com/api/1.0/customers/list.aspx

Request

<request>
    <customerList>
        <listType></listType>
    </customerList>
</request>
            
Parameters: listType: either 'basic' or 'full'

Response (for 'basic' list)

<response status="ok">
    <customer>
        <customerID></customerID>
        <customerName></customerName>
        <customerType></customerType>
        <inactive></inactive>
        <externalID></externalID>
    </customer>
</response>
            
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request