diff --git a/api-specs/checkout/types/responses/PermissionsNotFound.raml b/api-specs/checkout/types/responses/PermissionsNotFound.raml
new file mode 100644
index 000000000..d67fd9b16
--- /dev/null
+++ b/api-specs/checkout/types/responses/PermissionsNotFound.raml
@@ -0,0 +1,17 @@
+#%RAML 1.0 DataType
+(annotations.package): responses
+type: Message
+displayName: PermissionsNotFound
+discriminatorValue: no_permissions_found
+description: |
+  Generated when no [permissions](/permissions-subscription) to create a Composable Commerce API Client are found. To create permissions, in the Merchant Center navigation menu, go to any page under **commercetools Checkout** and click **Confirm creation**.
+properties:
+  code:
+    type: string
+    description:
+  severity:
+    type: string
+    description: \`warn`
+  message:
+    type: string
+    description: No permissions are found in your commercetools Checkout.
diff --git a/api-specs/checkout/types/types.raml b/api-specs/checkout/types/types.raml
index ba81708f4..617d9dbd5 100644
--- a/api-specs/checkout/types/types.raml
+++ b/api-specs/checkout/types/types.raml
@@ -33,6 +33,7 @@ PaymentValidationPassed: !include responses/PaymentValidationPassed.raml
 PaymentValidationStarted: !include responses/PaymentValidationStarted.raml
 PaymentVerificationStarted: !include responses/PaymentVerificationStarted.raml
 PaymentVerificationTimeout: !include responses/PaymentVerificationTimeout.raml
+PermissionsNotFound: !include responses/PermissionsNotFound.raml
 ExternalTermsAndConditionsPending: !include responses/ExternalTermsAndConditionsPending.raml
 SetShippingAddressError: !include responses/SetShippingAddressError.raml
 NoShippingMethods: !include responses/NoShippingMethods.raml