Skip to content

Use the Tasks API to associate tasks with CRM records. #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rpenha wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Use the Tasks API to associate tasks with CRM records. #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion HubSpot.Api.Test/Crm/ProductTests.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,4 +52,4 @@ public async void SearchAsync_ByName_Succeeds()

page.Results.Should().NotBeEmpty();
}
}
}
62 changes: 62 additions & 0 deletions HubSpot.Api.Test/Crm/TaskTests.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
using System.Net;
using FluentAssertions;
using HubSpot.Api.Exceptions;
using HubSpot.Api.Models;
using Xunit.Abstractions;

namespace HubSpot.Api.Test.Crm;

public class TaskTests(ITestOutputHelper testOutputHelper) : TestBase(testOutputHelper)
{
[Fact]
public async void CreateReadUpdateAndDelete_Succeeds()

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Codacy found a medium Performance issue: Return 'Task' instead.

The issue identified by the SonarC# linter is that the method CreateReadUpdateAndDelete_Succeeds is defined with a return type of async void. This is generally discouraged in asynchronous programming because it can lead to unhandled exceptions and makes it difficult to await the completion of the method. Instead, asynchronous methods should return a Task, which allows the calling code to await the method and handle exceptions properly.

To fix this issue, you should change the return type from async void to async Task. Here's the code suggestion to implement this change:

Suggested change
public async void CreateReadUpdateAndDelete_Succeeds()
public async Task CreateReadUpdateAndDelete_Succeeds()

This comment was generated by an experimental AI tool.

{
var createRequest = new CreateRequest
{
Properties = new Dictionary<string, string>
{
{ "hs_timestamp", "2019-10-30T03:30:17.883Z" },
{ "hs_task_body", """
<h3>Send Proposal</h3>
<a href="https://example.com">Example</a>
""" },
{ "hs_task_subject", "Follow-up for Brian Buyer" },
{ "hs_task_status", "NOT_STARTED" },
{ "hs_task_priority", "HIGH" },
{ "hs_task_type", "TODO" }
},
Associations = []
};

HubSpotObject createdObject;
try
{
createdObject = await Client.Crm.Tasks.CreateAsync(createRequest);
createdObject.Should().NotBeNull();
}
catch (HubSpotApiErrorException e) when (e.StatusCode == HttpStatusCode.Conflict)
{
e.Error.Category.Should().Be(ErrorCategory.Conflict);
createdObject = new HubSpotObject
{
Id = e.Message.Split(' ').Last(),
Properties = createRequest.Properties,
Archived = false,
CreatedAt = DateTime.UtcNow,
UpdatedAt = DateTime.UtcNow
};
}

// Re-read the item
var readObject = await Client.Crm.Tasks.GetAsync(createdObject.Id);
readObject.Should().NotBeNull();
readObject.Id.Should().Be(createdObject.Id);
readObject.Properties.Should().NotBeEmpty();

// Delete the item
await Client
.Crm
.Tasks
.ArchiveAsync(createdObject.Id);
}
}
3 changes: 1 addition & 2 deletions HubSpot.Api/Interfaces/Crm/IDeals.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,5 +56,4 @@ Task<CrmPage> SearchAsync(
[Body] SearchRequest searchRequest,
CancellationToken cancellationToken = default
);
}

}
55 changes: 55 additions & 0 deletions HubSpot.Api/Interfaces/Crm/ITasks.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
using HubSpot.Api.Models;
using Refit;

namespace HubSpot.Api.Interfaces.Crm;

public interface ITasks
{
// https://developers.hubspot.com/docs/guides/api/crm/engagements/tasks

[Post("/crm/v3/objects/tasks")]
Task<HubSpotObject> CreateAsync(
[Body] CreateRequest createRequest,
CancellationToken cancellationToken = default

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter is that using optional parameters, such as CancellationToken cancellationToken = default, can lead to ambiguity and can complicate method overload resolution. Instead of using optional parameters, the recommendation is to create an overload of the method that does not include the optional parameter. This approach improves clarity and allows for more precise method invocation.

To fix this issue, you can create an overloaded version of the GetAsync method that does not include the cancellationToken parameter, while keeping the original signature intact. Here's the suggested code change:

Suggested change
CancellationToken cancellationToken = default
Task<HubSpotObject> GetAsync(string id, IReadOnlyList<string>? properties = null, IReadOnlyList<string>? propertiesWithHistory = null, IReadOnlyList<string>? associations = null, bool? archived = null);

This comment was generated by an experimental AI tool.

);

[Get("/crm/v3/objects/tasks/{id}")]
Task<HubSpotObject> GetAsync(
string id,
[Query] IReadOnlyList<string>? properties = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter suggests that using optional parameters can lead to ambiguity and may hinder method overloading. Instead of using optional parameters, it is recommended to create overloaded methods that provide distinct signatures for different scenarios. This enhances clarity and makes the API more intuitive.

To address this issue, we can create an overloaded version of the GetAsync method that does not include the properties parameter. This way, we avoid using optional parameters altogether.

Here is the suggested change:

Suggested change
[Query] IReadOnlyList<string>? properties = null,
Task<HubSpotObject> GetAsync(string id, CancellationToken cancellationToken = default);

This comment was generated by an experimental AI tool.

[Query] IReadOnlyList<string>? propertiesWithHistory = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter is that using optional parameters can lead to ambiguity and can complicate method overloading. Instead of defining parameters as optional (with a default value of null), it's recommended to create overloaded methods that provide different combinations of parameters. This improves code clarity and usability.

To address the issue, you can remove the optional parameter and create an overloaded version of the GetAsync method that does not include propertiesWithHistory.

Here’s the single-line code suggestion to fix the issue by removing the optional parameter:

Suggested change
[Query] IReadOnlyList<string>? propertiesWithHistory = null,
Task<HubSpotObject> GetAsync(string id, IReadOnlyList<string>? properties = null, IReadOnlyList<string>? associations = null, bool? archived = null, CancellationToken cancellationToken = default);

You would then create a new overload for the method that includes the propertiesWithHistory parameter:

Suggested change
[Query] IReadOnlyList<string>? propertiesWithHistory = null,
Task<HubSpotObject> GetAsync(string id, IReadOnlyList<string>? properties = null, IReadOnlyList<string>? propertiesWithHistory = null, IReadOnlyList<string>? associations = null, bool? archived = null, CancellationToken cancellationToken = default);

This way, you can call the appropriate version of the method based on the parameters needed, avoiding the use of optional parameters.

This comment was generated by an experimental AI tool.

[Query] IReadOnlyList<string>? associations = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue highlighted by the SonarC# linter indicates that using optional parameters can lead to ambiguity and can complicate the method signature. Instead of using an optional parameter for associations, the linter suggests using method overloading to provide a clearer and more explicit API.

To fix this issue, we can create an overloaded version of the GetAsync method that does not include the associations parameter. This way, we can keep the method signatures clear and avoid potential confusion.

Here’s the suggested code change:

Suggested change
[Query] IReadOnlyList<string>? associations = null,
Task<HubSpotObject> GetAsync(string id, [Query] IReadOnlyList<string>? properties = null, [Query] IReadOnlyList<string>? propertiesWithHistory = null, [Query] bool? archived = null, CancellationToken cancellationToken = default);

This change involves creating a new overload of the GetAsync method without the associations parameter, which allows users to call the method without having to specify that parameter if it is not needed.

This comment was generated by an experimental AI tool.

[Query] bool? archived = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter is related to the use of optional parameters in the method signature. The linter suggests that instead of using optional parameters, you should use method overloading to provide different method signatures. This can improve clarity and usability by allowing callers to specify only the parameters they need without ambiguity.

To fix this issue, you can create an overloaded version of the GetAsync method that does not include the archived parameter. This way, you can maintain the functionality while adhering to the linter's recommendation.

Here's the code suggestion to implement this change:

Suggested change
[Query] bool? archived = null,
Task<HubSpotObject> GetAsync(string id, IReadOnlyList<string>? properties = null, IReadOnlyList<string>? propertiesWithHistory = null, IReadOnlyList<string>? associations = null, CancellationToken cancellationToken = default);

This comment was generated by an experimental AI tool.

CancellationToken cancellationToken = default
);

[Patch("/crm/v3/objects/tasks/{id}")]
Task<HubSpotObject> PatchAsync(
string id,
[Body] HubSpotPatchObject hubSpotObject,
CancellationToken cancellationToken = default
);

[Get("/crm/v3/objects/tasks")]
Task<CrmPage> GetPageAsync(
int? limit = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter is that the use of optional parameters (like int? limit = null) can lead to ambiguity and make the method signatures less clear, especially when there are multiple optional parameters. Instead, it is recommended to use method overloading to provide different variations of the method for different parameter combinations. This approach enhances readability and maintainability.

To fix the issue, we can provide an overloaded version of the GetPageAsync method that does not take the limit parameter, allowing the caller to choose between the two versions.

Here's the code suggestion to implement this change:

Suggested change
int? limit = null,
Task<CrmPage> GetPageAsync(CancellationToken cancellationToken = default) => GetPageAsync(null, cancellationToken);

This line adds an overload of the GetPageAsync method that defaults to not specifying a limit, thus addressing the linter's recommendation.

This comment was generated by an experimental AI tool.

string? after = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter suggests that instead of using optional parameters (like string? after = null), you should utilize method overloading. This is because optional parameters can lead to ambiguity and make the API less clear for consumers. Overloading allows you to create multiple methods with the same name but different parameters, enhancing readability and usability.

To resolve this issue, you can create an overloaded version of the GetPageAsync method without the optional after parameter.

Here’s the suggested change:

Suggested change
string? after = null,
Task<CrmPage> GetPageAsync(int? limit = null, ICollection<string>? properties = null, ICollection<string>? propertiesWithHistory = null, ICollection<string>? associations = null, bool? archived = null, CancellationToken cancellationToken = default);

This comment was generated by an experimental AI tool.

ICollection<string>? properties = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter is that optional parameters can lead to ambiguity in method overloads, especially when there are multiple optional parameters of the same type. Instead of using optional parameters, the linter suggests using method overloading to provide clearer and more maintainable code.

To fix the issue, we can create an overloaded version of the GetPageAsync method that does not include the properties parameter. This way, we provide an alternative method for cases where the caller does not need to specify properties.

Here's the suggested change:

Suggested change
ICollection<string>? properties = null,
Task<CrmPage> GetPageAsync(int? limit = null, string? after = null, ICollection<string>? propertiesWithHistory = null, ICollection<string>? associations = null, bool? archived = null, CancellationToken cancellationToken = default);

This change involves creating an overload that omits the properties parameter, allowing for clearer method calls without the ambiguity of optional parameters.

This comment was generated by an experimental AI tool.

ICollection<string>? propertiesWithHistory = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter suggests that using optional parameters can lead to ambiguity and can make the method signature less clear. Instead of using optional parameters, it recommends using method overloading to provide different variations of the method for different use cases. This can improve code readability and maintainability.

To address this, we can create an overloaded method that omits the propertiesWithHistory parameter. Here’s how you can modify the method signature:

Suggested change
ICollection<string>? propertiesWithHistory = null,
Task<CrmPage> GetPageAsync(int? limit = null, string? after = null, ICollection<string>? properties = null, ICollection<string>? associations = null, bool? archived = null, CancellationToken cancellationToken = default);

This change removes the optional parameter propertiesWithHistory from the original method signature, allowing for a clearer method definition. You would also need to create an overloaded version of the method that includes propertiesWithHistory as a required parameter.

This comment was generated by an experimental AI tool.

ICollection<string>? associations = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter suggests that instead of using optional parameters in the method signature, you should consider using method overloading. This is because optional parameters can lead to ambiguity and make the API less clear, especially when there are multiple optional parameters.

To resolve the issue, you can create an overloaded version of the GetPageAsync method that does not include the associations parameter. This way, you provide a more explicit API design.

Here's the suggested change:

Suggested change
ICollection<string>? associations = null,
Task<CrmPage> GetPageAsync(int? limit = null, string? after = null, ICollection<string>? properties = null, ICollection<string>? propertiesWithHistory = null, bool? archived = null, CancellationToken cancellationToken = default);

This change creates a new method overload without the associations parameter, allowing users to call the method without needing to specify all optional parameters.

This comment was generated by an experimental AI tool.

bool? archived = null,

@codacy-production codacy-production Bot Mar 10, 2025

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ Codacy found a critical ErrorProne issue: Use the overloading mechanism instead of the optional parameters.

The issue identified by the SonarC# linter is that optional parameters can lead to ambiguity and may complicate method overloading and usage. Instead of using optional parameters, it's recommended to create overloaded versions of the method to handle different scenarios. This can improve code clarity and maintainability.

To fix the issue, we can create an overloaded version of the GetPageAsync method that does not include the archived parameter. This way, we maintain clarity and avoid potential pitfalls associated with optional parameters.

Here's the code suggestion to implement this change:

Suggested change
bool? archived = null,
Task<CrmPage> GetPageAsync(int? limit = null, string? after = null, ICollection<string>? properties = null, ICollection<string>? propertiesWithHistory = null, ICollection<string>? associations = null, CancellationToken cancellationToken = default);

This comment was generated by an experimental AI tool.

CancellationToken cancellationToken = default
);

[Delete("/crm/v3/objects/tasks/{id}")]
Task ArchiveAsync(
string id,
CancellationToken cancellationToken = default
);

[Post("/crm/v3/objects/tasks/search")]
Task<CrmPage> SearchAsync(
[Body] SearchRequest searchRequest,
CancellationToken cancellationToken = default
);
}
3 changes: 3 additions & 0 deletions HubSpot.Api/Sections/Crm.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,4 +31,7 @@ public class Crm(HttpClient httpClient, RefitSettings refitSettings)

public ITickets Tickets { get; init; }
= RestService.For<ITickets>(httpClient, refitSettings);

public ITasks Tasks { get; init; }
= RestService.For<ITasks>(httpClient, refitSettings);
}
83 changes: 42 additions & 41 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,46 +53,47 @@ Key:
| :green_square: | Full |


| Type | Object | Documentation | HubSpot API Status | Nuget Coverage |
| - | - | - | - | - |
| Analytics | Analytics | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/events/v3/send) | Developer Preview | :black_circle: |
| Auth | Auth | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/oauth/v1) | Latest | :black_circle: |
| Automation | Automation | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/automation/v4/actions) | Latest | :black_circle: |
| Business Units | Business Units | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/business-units/v3) | Stable | :black_circle: |
| Type | Object | Documentation | HubSpot API Status | Nuget Coverage |
| - |---------------------------| - | - | - |
| Analytics | Analytics | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/events/v3/send) | Developer Preview | :black_circle: |
| Auth | Auth | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/oauth/v1) | Latest | :black_circle: |
| Automation | Automation | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/automation/v4/actions) | Latest | :black_circle: |
| Business Units | Business Units | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/business-units/v3) | Stable | :black_circle: |
| Communication Preferences | Communication Preferences | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/communication-preferences/v3) | Developer Preview | :black_circle: |
| Conversations | Conversations | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/conversations/v3/visitor-identification) | Latest | :black_circle: |
| CMS | Domains | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/domains) | Developer Preview | :yellow_circle: |
| CMS | Source Code | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/source-code) | Developer Preview | :black_circle: |
| CMS | Blog Posts | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/blogs/blog-posts) | Developer Preview | :black_circle: |
| CMS | Authors | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/blogs/authors) | Developer Preview | :black_circle: |
| CMS | URL Redirects | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/url-redirects) | Developer Preview | :black_circle: |
| CMS | Performance | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/performance) | Developer Preview | :black_circle: |
| CMS | Hubdb | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/hubdb) | Developer Preview | :black_circle: |
| CMS | Tags | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/blogs/tags) | Developer Preview | :black_circle: |
| CMS | Audit Logs | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/audit-logs) | Developer Preview | :black_circle: |
| CMS | Site Search | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/site-search) | Developer Preview | :black_circle: |
| CRM | Accounting | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/extensions/accounting) | Latest | :black_circle: |
| CRM | Associations | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/associations) | Latest | :black_circle: |
| CRM | Associations (v4) | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v4/associations) | Stable | :black_circle: |
| CRM | Calling | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/extensions/calling) | Latest | :black_circle: |
| CRM | Companies | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/companies) | Latest | :yellow_circle: |
| CRM | Contacts | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/contacts) | Latest | :yellow_circle: |
| CRM | Extensions | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/extensions/sales-objects/v1/object-types) | Latest | :black_circle: |
| CRM | Deals | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/deals) | Latest | :yellow_circle: |
| CRM | Feedback Submissions | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/feedback_submissions) | Developer Preview | :yellow_circle: |
| CRM | Imports | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/imports) | Latest | :black_circle: |
| CRM | Line Items | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/line_items) | Latest | :yellow_circle: |
| CRM | Objects | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects) | Latest | :black_circle: |
| CRM | Owners | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/owners) | Latest | :black_circle: |
| CRM | Pipelines | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/pipelines) | Latest | :black_circle: |
| CRM | Properties | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/properties) | Latest | :black_circle: |
| CRM | Quotes | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/quotes) | Latest | :black_circle: |
| CRM | Schemas | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/schemas) | Latest | :black_circle: |
| CRM | Tickets | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/tickets) | Latest | :yellow_circle: |
| CRM | Timeline | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/timeline) | Latest | :black_circle: |
| CRM | Videoconferencing | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/extensions/videoconferencing) | Latest | :black_circle: |
| Events | Events | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/events/v3/events) | Developer Preview | :black_circle: |
| Marketing | Marketing Events (beta) | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/marketing/v3/marketing-events-beta) | Latest | :black_circle: |
| Marketing | Transactional | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/marketing/v3/transactional) | Latest | :black_circle: |
| Webhooks | Webhooks | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/webhooks/v3) | Latest | :black_circle: |
| Conversations | Conversations | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/conversations/v3/visitor-identification) | Latest | :black_circle: |
| CMS | Domains | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/domains) | Developer Preview | :yellow_circle: |
| CMS | Source Code | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/source-code) | Developer Preview | :black_circle: |
| CMS | Blog Posts | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/blogs/blog-posts) | Developer Preview | :black_circle: |
| CMS | Authors | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/blogs/authors) | Developer Preview | :black_circle: |
| CMS | URL Redirects | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/url-redirects) | Developer Preview | :black_circle: |
| CMS | Performance | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/performance) | Developer Preview | :black_circle: |
| CMS | Hubdb | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/hubdb) | Developer Preview | :black_circle: |
| CMS | Tags | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/blogs/tags) | Developer Preview | :black_circle: |
| CMS | Audit Logs | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/audit-logs) | Developer Preview | :black_circle: |
| CMS | Site Search | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/cms/v3/site-search) | Developer Preview | :black_circle: |
| CRM | Accounting | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/extensions/accounting) | Latest | :black_circle: |
| CRM | Associations | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/associations) | Latest | :black_circle: |
| CRM | Associations (v4) | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v4/associations) | Stable | :black_circle: |
| CRM | Calling | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/extensions/calling) | Latest | :black_circle: |
| CRM | Companies | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/companies) | Latest | :yellow_circle: |
| CRM | Contacts | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/contacts) | Latest | :yellow_circle: |
| CRM | Extensions | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/extensions/sales-objects/v1/object-types) | Latest | :black_circle: |
| CRM | Deals | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/deals) | Latest | :yellow_circle: |
| CRM | Feedback Submissions | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/feedback_submissions) | Developer Preview | :yellow_circle: |
| CRM | Imports | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/imports) | Latest | :black_circle: |
| CRM | Line Items | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/line_items) | Latest | :yellow_circle: |
| CRM | Objects | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects) | Latest | :black_circle: |
| CRM | Owners | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/owners) | Latest | :black_circle: |
| CRM | Pipelines | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/pipelines) | Latest | :black_circle: |
| CRM | Properties | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/properties) | Latest | :black_circle: |
| CRM | Quotes | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/quotes) | Latest | :black_circle: |
| CRM | Schemas | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/schemas) | Latest | :black_circle: |
| CRM | Tickets | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/tickets) | Latest | :yellow_circle: |
| CRM | Timeline | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/timeline) | Latest | :black_circle: |
| CRM | Videoconferencing | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/extensions/videoconferencing) | Latest | :black_circle: |
| CRM | Tasks | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/crm/v3/objects/tasks) | Latest | :yellow_circle: |
| Events | Events | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/events/v3/events) | Developer Preview | :black_circle: |
| Marketing | Marketing Events (beta) | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/marketing/v3/marketing-events-beta) | Latest | :black_circle: |
| Marketing | Transactional | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/marketing/v3/transactional) | Latest | :black_circle: |
| Webhooks | Webhooks | [Link](https://api.hubspot.com/api-catalog-public/v1/apis/webhooks/v3) | Latest | :black_circle: |