Add P4 Plan webhooks

You can add webhooks that integrate P4 Plan with P4 DAM to share information between the applications.

After a P4 DAM company administrator adds a P4 Plan webhook, P4 DAM users can add P4 Plan item links to assets. Basic information about the P4 Plan item and a link is displayed with the asset. When the asset is updated, the webhook runs and information is automatically sent and displayed in the related P4 Plan item as a comment. To learn more about webhooks, see Webhooks.

You can also add custom webhooks to integrate P4 DAM with other external services. To learn more, see Add custom webhooks.

P4 Plan webhooks can only be created at the company level, they cannot be created at the project level. You must be a company administrator to work with webhooks at the company level.

Version requirements

The P4 Plan webhooks integration requires:

P4 Plan Server 2024.2/010 and later
P4 Plan Web 2024.2/003 and later.

When webhooks run

P4 Plan webhooks run when users:

Asset updated, which includes:
- Adding new asset versions.
- Moving assets.
- Renaming assets.
- Deleting assets.
Bundle content updated, which includes adding or excluding items, such as assets, folders, or other bundles, from a bundle. To manage the path rules for a bundle, see Manage items in an asset bundle.
Bundle review content updated, which includes adding or excluding items, such as assets, folders, or other bundles, from a bundle review. To manage the path rules for a bundle review, see Manage asset bundle review content.
Comment added to asset, bundle, or bundle review.
Link added to asset, bundle, or bundle review.
Review created.
Review deleted.
Review status updated: The webhook can run for all state changes, but it is restricted by the workflow transition rules it is added to. For example, if a transition rule allows a review state to change from Open to In progress and a webhook is part of the transition rule, the webhook only runs for that state change. To learn more, see Create company workflows.

Step 1: Create an integration user

Before integrating P4 Plan with P4 DAM, create an integration user and assign it as the main manager in the required projects in P4 Plan.

Create an integration user in P4 Plan.

To create a user in P4 Plan, see Adding a team member to P4 Plan in the P4 Plan documentation.
Set the user settings to Is a main manager to allow the webhook integration user to perform actions such as accessing projects, searching for items, and adding comments.

To change user settings in P4 Plan, see Changing project user settings in the P4 Plan documentation.

Step 2: Configure a webhook

In P4 DAM, click your user avatar and click Company settings.
From the Company settings pane, click Webhooks.
On the Webhooks page, click Add webhook.

On the Define details tab in the Add webhook pane, enter general information about the webhook.

Field	Description
Name	Enter a name for the webhook to distinguish it from other webhooks. For example, you might want to use P4 Plan to make it easily identifiable to users when they add links to assets.
Type	From the Type dropdown, click P4 Plan. To add a custom webhook that integrates with other external services, see Add custom webhooks.
Projects	By default, the webhook runs on all projects. To only run the webhook on specific projects, click the projects in the list. You can search for a project. To remove a project, click X next to it.
Repositories/collections	By default, the webhook runs on all collections in the projects. To only run the webhook on specific collections, click the collections in the list. You can search for a collection. To remove a collection, click X next to it.
Events that trigger webhook	By default, the webhook runs for all supported events for P4 DAM assets. To only run the webhook when specific events occur, click the events in the list. To remove an event, click X next to it.
Interval	Choose whether to run the webhook immediately after the event is performed or at a specified interval. An interval 5 minutes or more sends a batch of events that occur during the interval time.

Click Continue.

On the Configure webhook tab, enter the P4 Plan URL, authentication parameters, and advanced options to customize the webhook.

Field	Description
URL	Web client URL for P4 Plan to connect to P4 DAM.
Insecure SSL	If P4 Plan uses an SSL/TLS certificate that cannot be verified, such as a self-signed certificate, click Insecure SSL.
Authentication parameters	Authenticate to P4 Plan using a username and either a token or a password. A token is valid for two years, but you can change the expiration date. To use a P4 Plan token, see Adding authentication tokens in the P4 Plan documentation. A password is valid for one hour.
Advanced settings	Optional. Click the arrow to expand the area and set the options. To override the default proxy configuration for the P4 DAM instance, click Use custom proxy configuration. Enter a custom proxy URL or leave the field empty if you do not want to use a proxy. To restrict when webhooks run based on reference path patterns, see Restrict when webhooks run (Optional).

Click Finish.
The webhook is added. Users can now add P4 Plan links to P4 DAM assets. To learn more, see Links.
If you need to prevent the webhook from running temporarily, open the Webhooks pane, click the vertical ellipsis button for the webhook, and click Inactivate. The webhook is displayed as Inactive on the Webhooks pane. To learn more, see Manage webhooks.
If you cannot save the webhook because P4 DAM cannot communicate with P4 Plan, see Troubleshoot P4 Plan integration issues.