Create and Manage Employer Records via the API

Introduction 

This is likely to be useful for customers who would like to integrate Bud with their CRM Systems which already house their client's organisational structure. Bud provides the ability to:

• Create new employers
• Retrieve information about a given employer
• Update the address of an employer
• Change the parent record of an employer

Create Employers

You can create Employers and their location by the API. This includes:

• Some metadata about the Employer, like if they are Levy Paying. 
• The location
• The Employer Contact you want against that Employer. 

It is also possible to set the Employer ID, which means you can use your own identifier when updating or retrieving Employer information. 

Retrieve Employer Information

While providing the Employer ID, you can get some high level information about that Employer:

• Name
• List of Employer Contacts

Update the address of an employer

This endpoint allows you to keep the addresses of your employers up to date. You must provide the Employer ID. 

Re-parent an Employer

It is possible to amend the structure of your employer hierarchy using this endpoint, simply provide the Employer ID of the record to change, and the Employer ID of the record to set as its parent Employer.