-
Notifications
You must be signed in to change notification settings - Fork 5.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
b910e7f
commit 4cccbe0
Showing
1 changed file
with
68 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,17 +1,81 @@ | ||
| # Overview | ||
|
|
||
| Notion's API allows for the creation, reading, updating, and deleting of pages, databases, and their contents within Notion. Leveraging Pipedream's platform, you can build workflows that connect Notion with a myriad of other services to automate tasks such as content management, task tracking, and data synchronization. With Pipedream's serverless execution, you can trigger these workflows on a schedule, or by external events from other services, without managing any infrastructure. | ||
| Notion's API allows for the creation, reading, updating, and deleting of pages, databases, and their contents within Notion. Using Pipedream's platform, you can build workflows that connect Notion with various other services to automate tasks such as content management, task tracking, and data synchronization. With Pipedream's serverless execution, you can trigger these workflows on a schedule, or by external events from other services, without managing any infrastructure. | ||
|
|
||
| # Example Use Cases | ||
|
|
||
| - **Content Sync Between Notion and a CMS**: Automatically push new blog posts from a Notion database to a CMS like WordPress, ensuring a seamless content flow from drafting to publishing. | ||
| - **Content Sync Between Notion and a CMS**: Automatically push new blog posts from Notion to WordPress, ensuring a seamless content flow from drafting to publishing. | ||
|
|
||
| - **Task Management with Todoist Integration**: When a new task is added to a Notion database, create a corresponding task in Todoist, and vice versa, keeping task lists synced across platforms. | ||
|
|
||
| - **Daily Sales Report Generation**: Gather sales data from a tool like Shopify at the end of each day, sum up total sales, and create a page in Notion with the day's sales summary for easy reporting. | ||
|
|
||
| # Getting Started | ||
|
|
||
| To get started, first log in to or create your [Pipedream account](https://pipedream.com) and start a new workflow. | ||
|
|
||
| Add a Notion action or trigger to your workflow, then click **Select a Notion account** to open a Notion connection window: | ||
|
|
||
|  | ||
|
|
||
| From within this window, select pages you'd like Pipedream to access: | ||
|
|
||
|  | ||
|
|
||
| Click **Accept** to connect your Notion account to Pipedream. | ||
|
|
||
| # Troubleshooting | ||
|
|
||
| Note: After creating a new database, please reconnect your account and select it to enable access to Pipedream. | ||
| ## Unable to find a new database | ||
|
|
||
| After creating a new database, reconnect your account and select it to enable Pipedream access. | ||
|
|
||
| ## HTTP errors | ||
|
|
||
| ### 400 "invalid_json" | ||
| Ensure the request body is formatted as valid JSON. | ||
|
|
||
| ### 400 "invalid_request_url" | ||
| The URL in your request is incorrect. Ensure the correct format and parameters. | ||
|
|
||
| ### 400 "invalid_request" | ||
| The request type isn't supported. Ensure the correct format and parameters. | ||
|
|
||
| ### 400 "invalid_grant" | ||
| Your authorization grant or refresh token is invalid, expired, or mismatched. Refer to OAuth 2.0 documentation. | ||
|
|
||
| ### 400 "validation_error" | ||
| The request body doesn't match the expected parameters schema. You're most likely missing a key parameter, or a parameter is malformed. | ||
|
|
||
| ### 400 "missing_version" | ||
| If your request lacks the required `Notion-Version` header, try adding a new Notion step in Pipedream, as it should handle this automatically. | ||
|
|
||
| ### 401 "unauthorized" | ||
| If your API token is invalid, reconnect your Notion account to Pipedream. | ||
|
|
||
| ### 403 "restricted_resource" | ||
| Your API token doesn't have permission to perform this operation. Try reconnecting your Notion account to Pipedream. | ||
|
|
||
| ### 404 "object_not_found" | ||
| The requested resource doesn't exist or isn't shared with your API token. Double check that the block, database or page exists. | ||
|
|
||
| ### 409 "conflict_error" | ||
| A conflict occurred, possibly due to outdated parameters. Try updating your parameters. | ||
|
|
||
| ### 429 "rate_limited" | ||
| You've exceeded the number of allowed requests. Slow down your request rate. | ||
|
|
||
| ### 500 "internal_server_error" | ||
| An unexpected error has occurred. Contact Notion support if it persists. | ||
|
|
||
| ### 502 "bad_gateway" | ||
| Notion had a problem processing your request, possibly due to an upstream server issue. | ||
|
|
||
| ### 503 "service_unavailable" | ||
| Notion is temporarily unavailable, possibly due to a long response time. Try again later. | ||
|
|
||
| ### 503 "database_connection_unavailable" | ||
| Notion's database cannot be queried at the moment. Try again later. | ||
|
|
||
| Please [reach out](https://pipedream.com/support/) to the Pipedream team with any technical issues or questions about the Notion integration. We're happy to help! | ||
| ### 504 "gateway_timeout" | ||
| Your request to Notion timed out. Try resending it after a while. |