HubSpot.NET

.NET Core Wrapper around the common HubSpot APIs:

• Contact
• Company
• Deal
• Engagement
• Owners
• COS Files API (adds the ability to upload files to use as attachments to engagements)
• Email Subscriptions (currently GET & PUT)
• Timeline API
  • Timeline EventTypes
  • Timeline Events

Authorization

HubSpot.NET supports authorization by API key or through HubSpot's OAuth workflow.

Getting Started

To get started, install the Nuget package and create a instance of HubSpotApi passing your API Key as the only parameter; or if using OAuth pass in the Client ID, Client Secret, and App ID.

API Key

  var api = new HubSpotApi("MY API KEY");

  // Create a contact
  var contact = api.Contact.Create(new ContactHubSpotModel()
  {
      Email = "[email protected]",
      FirstName = "John",
      LastName = "Smith",
      Phone = "00000 000000",
      Company = "Squared Up Ltd."
  });

OAuth

  var api = new HubSpotApi("clientID", "clientSecret", "HubSpotAppID");

  // Create a contact
  var contact = api.Contact.Create(new ContactHubSpotModel()
  {
      Email = "[email protected]",
      FirstName = "John",
      LastName = "Smith",
      Phone = "00000 000000",
      Company = "Squared Up Ltd."
  });

For more examples see the HubSpot.NET.Examples project.

Using your own models

As HubSpot lets you create and add custom properties to your contacts, companies and deals it's likely you'll want to implement your own models. This is straightforward, simply extend the models shipped with this library, e.g. ContactHubSpotModel and add your own properties. Use the DataMember attributes to indicate the internal name. For example

  public class Contact : ContactHubSpotModel
  {
      [DataMember(Name = "activities")]
      public string Activities { get; set; }

      [DataMember(Name = "type")]
      public string Type { get; set; }
  }

Using checkbox/radio properties

These properties should be of type string and set as a semicolon delimitered list of values, e.g. "value1;value2". This is required by HubSpot, see here for more details.

Contributing

Please read CONTRIBUTING.md for more information on how to contribute. PRs welcome!

Maintainers

• PowerDairy

Original Authors

• Dave Clarke

This project is a fork of HubSpot.NET, originally created by Dave Clarke. We are grateful for their work and contribution.

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgements

• Initial version based on dotnetcore-hubspot-client by skarpdev, expanded to additional APIs and heavily refactored to use RestSharp etc.