Troubleshooting

I can't sign in

• Verify you are using the correct SSO identity provider for your workspace.
• If you are an integration user, confirm your API key or OAuth token has not expired and carries the required ggnomad:* permissions.
• Clear browser cookies and try again, or contact your workspace administrator.

My workspace isn't loading

• GGNomad requires a workspace context. Confirm your identity is a member of the workspace you are trying to access.
• If you are calling the API directly, include the x-workspace-id header (or let the gateway derive it from your session).

A listing I created isn't showing in discovery

• Listings must pass the verification lifecycle (created → submitted → verified/active) before they appear in discovery.
• Check that the listing's availability toggle is on and that the dates you are searching are not blacked out.
• Ensure the listing is scoped to the correct workspace.

My booking won't confirm

• Verify the listing has available capacity for the selected dates and guest count.
• Check that your identity carries the ggnomad:write permission for bookings.
• Review the itemized totals for any validation errors (e.g., minimum stay not met).

API errors

Common GraphQL error codes and what to do:

Code	Meaning	Resolution
UNAUTHENTICATED	No valid token	Re-authenticate or refresh your token
FORBIDDEN	Missing permission	Request the required ggnomad:* scope
WORKSPACE_REQUIRED	No workspace context	Include workspace id or sign in via SSO
NOT_FOUND	Target doesn't exist	Verify the id belongs to the current workspace
VALIDATION_ERROR	Input failed validation	Check field constraints and retry

Still stuck?

Contact the GGNomad support team at [email protected].