From fe26c422765fadb06c3174f07e5fbaad4c0e4da9 Mon Sep 17 00:00:00 2001
From: Cerallin <66366855+Cerallin@users.noreply.github.com>
Date: Tue, 27 May 2025 13:06:55 +0800
Subject: [PATCH] Add documentation for seventeentrack.add_package (#39252)

---
 source/_integrations/seventeentrack.markdown | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/source/_integrations/seventeentrack.markdown b/source/_integrations/seventeentrack.markdown
index 975156772ec..3207741ffdc 100644
--- a/source/_integrations/seventeentrack.markdown
+++ b/source/_integrations/seventeentrack.markdown
@@ -108,3 +108,22 @@ The `seventeentrack.archive_package` action allows you to archive a package usin
     config_entry_id: 2b4be47a1fa7c3764f14cf756dc98991
     package_tracking_number: RU0103445624A
 ```
+
+### Action `seventeentrack.add_package`
+
+The `seventeentrack.add_package` action allows you to add a package using the 17track API.
+
+| Data attribute            | Optional | Description                                   |
+| ------------------------- | -------- | --------------------------------------------- |
+| `config_entry_id`         | No       | The selected service to add the package to.   |
+| `package_tracking_number` | No       | The package tracking number to add.           |
+| `package_friendly_name`   | No       | The friendly name of the package to be added. |
+
+```yaml
+# Example automation action to add a package with tracking number and its friendly name
+- action: seventeentrack.add_package
+  data:
+    config_entry_id: 2b4be47a1fa7c3764f14cf756dc98991
+    package_tracking_number: RU0103445624A
+    package_friendly_name: "Example Package"
+```