Goals API - Creating Custom Goal - Doesn't show in UI

DSmith11 — Wed, 16 Apr 2025 19:17:04 GMT

Hello,

I recently found the documentation for the Goals API and I have been attempting to create custom goals via this API.

I have been able to successfully do so (judging by the successful API responses I get), but the resulting goals so far don't appear correctly in the UI.

Here's the steps I took:

Created a custom goal normally through the UI
Used a GET request to retrieve all fields for this created goal
copied all relevant fields from Step 2, changed the `hs_goal_name` and submitted as a new goal via a POST request
Confirmed response from Step 3 was successful
Inside Hubspot under Reporting > Goals attempted to find my new goal
Noticed goal was not present in the default list with no filters
Clicked on the "Goal Name" dropdown filter and saw the name of my new goal there
Click my goal name in the name filter, noticed no results were returned

I am thinking that I may be misconfiguring my goals somehow or missing an otherwise required field. I will include my request below (with some ids redacted):

{ "properties":{ "hs__migration_soft_delete": null, "hs_ad_account_asset_ids": null, "hs_ad_campaign_asset_ids": null, "hs_all_accessible_team_ids": null, "hs_all_assigned_business_unit_ids": null, "hs_all_owner_ids": null, "hs_all_team_ids": null, "hs_assignee_user_id": "REDACTED", "hs_campaign_asset_ids": null, "hs_contact_lifecycle_stage": null, "hs_currency": null, "hs_currency_exchange_rate": null, "hs_deal_pipeline_ids": "default", "hs_edit_updates_notification_frequency": "weekly", "hs_effective_marketing_kpi_start_datetime": null, "hs_end_date": null, "hs_end_datetime": "2025-12-31T23:59:59.998Z", "hs_fiscal_year_offset": "0", "hs_goal_name": "API Recreation of Goal - Test", "hs_goal_target_currency_code": "USD", "hs_goal_type": "standard_object_custom_goal", "hs_is_forecastable": "true", "hs_is_legacy": null, "hs_kpi_attribution_model": null, "hs_kpi_display_unit": null, "hs_kpi_filter_groups": "[{\"filters\":[{\"value\":\"REDACTED\",\"property\":\"associations.company\",\"operator\":\"EQ\"},{\"values\":[\"default\"],\"property\":\"pipeline\",\"operator\":\"IN\"}]}]", "hs_kpi_filter_groups_for_key_grouping": "[{\"filters\":[{\"value\":\"REDACTED\",\"property\":\"associations.company\",\"operator\":\"EQ\"}]}]", "hs_kpi_filter_groups_for_key_team_grouping": "[{\"filters\":[{\"value\":\"REDACTED\",\"property\":\"associations.company\",\"operator\":\"EQ\"}]}]", "hs_kpi_is_team_rollup": "false", "hs_kpi_metric_type": "SUM", "hs_kpi_object_type_id": "0-3", "hs_kpi_property_name": "hs_projected_amount_in_home_currency", "hs_kpi_single_object_custom_goal_type_name": "sum_hs_projected_amount_in_home_currency_0-3", "hs_kpi_time_period_property": "closedate", "hs_kpi_tracking_method": "HIGHER_IS_BETTER", "hs_kpi_unit_type": "currency", "hs_kpi_value_calculated_at": null, "hs_kpi_value_last_calculated_at": null, "hs_legacy_active": null, "hs_legacy_created_at": null, "hs_legacy_created_by": null, "hs_legacy_quarterly_target_composite_id": null, "hs_legacy_sql_id": null, "hs_legacy_unique_sql_id": null, "hs_legacy_updated_at": null, "hs_legacy_updated_by": null, "hs_marketing_campaign_object_ids": null, "hs_merged_object_ids": null, "hs_migration_soft_delete": null, "hs_milestone": "yearly", "hs_outcome": "in_progress", "hs_pipeline_ids": "default", "hs_pipelines": "default", "hs_progress_updates_notification_frequency": "weekly", "hs_read_only": null, "hs_shared_team_ids": null, "hs_shared_user_ids": null, "hs_should_notify_on_achieved": "false", "hs_should_notify_on_edit_updates": "false", "hs_should_notify_on_exceeded": "false", "hs_should_notify_on_kickoff": "false", "hs_should_notify_on_missed": "false", "hs_should_notify_on_progress_updates": "false", "hs_should_recalculate": "true", "hs_start_date": null, "hs_start_datetime": "2025-01-01T00:00:00Z", "hs_static_kpi_filter_groups": null, "hs_status": "in_progress", "hs_target_amount": "1000000.00", "hs_team_id": null, "hs_template_id": null, "hs_ticket_pipeline_ids": null, "hs_user_id": null, "hs_was_imported": null, "hubspot_owner_assigneddate": null, "hubspot_owner_id": "REDACTED", "hubspot_team_id": null } }

Anyone with experience creating custom goals via API that can spot what I'm missing here?

Re: Goals API - Creating Custom Goal - Doesn't show in UI

GiantFocal — Fri, 27 Jun 2025 06:22:29 GMT

The issue you’re seeing (goal appears in filter dropdown but not in the list or results) usually comes down to one of two things: either a required property is missing/incorrect, or there’s a mismatch in how the goal is associated with teams, users, or pipelines.

Here are a few things to check and try:

Assignee & Team Fields: Make sure ‎`hs_assignee_user_id`, ‎`hs_team_id`, and ‎`hubspot_team_id` are set correctly. If these are null or mismatched, the goal might not show up in the UI list, even if it’s filterable.
Pipeline & Object Type: Double-check that ‎`hs_deal_pipeline_ids`, ‎`hs_pipeline_ids`, and ‎`hs_kpi_object_type_id` match exactly what’s used for goals created in the UI. Any difference here can cause visibility issues.
Start/End Dates: You’ve got ‎`hs_start_datetime` and ‎`hs_end_datetime` set, but ‎`hs_start_date` and ‎`hs_end_date` are null. Sometimes, the UI expects both formats. Try setting both.
Goal Status: Confirm that ‎`hs_status` is set to a value the UI recognizes (like ‎`in_progress` or ‎`active`).

If you’ve matched everything from a UI-created goal and still have issues, try creating a new goal using the UI, then immediately pull all its properties with a GET request and compare, sometimes there are hidden fields or metadata the UI uses that aren’t obvious.

Hope this helps! Please let me know if you notice any differences or if you'd like to share a redacted GET response from a working goal for a closer review.

topic Goals API - Creating Custom Goal - Doesn't show in UI in APIs & Integrations

Goals API - Creating Custom Goal - Doesn't show in UI

Re: Goals API - Creating Custom Goal - Doesn't show in UI