Crafting Event Finder Submissions API
The submissions API from Crafting Event Finder — 1 operation(s) for submissions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/craftingeventfinder-com:craftingeventfinder-com-submissions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Crafting Event Finder Submissions API
version: 1.0.0
description: Everything the site does is available here, and as MCP tools at /api/mcp.
servers:
- url: https://craftingeventfinder.com
tags:
- name: Submissions
paths:
/api/submissions:
post:
summary: Submit an event for review
description: Goes to the moderation queue. Browser forms pass Turnstile; programmatic callers send an API key instead. A signed-in caller (session or user-scope key) skips Turnstile, is recorded as the submitter, may omit organizer_email (the account email is used), and a trusted submitter's event can publish straight away when auto-approval is on. Anonymous callers must send organizer_email.
tags:
- Submissions
security: []
requestBody:
content:
application/json:
schema:
type: object
properties:
title:
type: string
minLength: 1
maxLength: 200
start_date:
type: string
pattern: ^\d{4}-\d{2}-\d{2}$
end_date:
anyOf:
- type: string
pattern: ^\d{4}-\d{2}-\d{2}$
- type: string
enum:
- ''
city:
type: string
maxLength: 100
description: The town; required unless location_kind is online
state:
type: string
maxLength: 40
description: A US state name or two-letter code; required unless location_kind is online (then taken from the time zone)
venue:
type: string
maxLength: 200
street_address:
type: string
maxLength: 200
postal_code:
anyOf:
- type: string
pattern: ^\d{5}$
- type: string
enum:
- ''
location_kind:
type: string
enum:
- venue
- online
- hybrid
- multi
timezone:
type: string
maxLength: 64
description: The event's own clock (IANA, like America/Chicago); required for an online or hybrid event
languages:
type: array
items:
type: string
maxLength: 40
maxItems: 5
description: The languages the event is held in, as BCP 47 codes (en, es); leave out when unknown
hosted_by:
type: string
maxLength: 120
description: The group or shop hosting an online or hybrid event
craft_types:
type: array
items:
type: string
minLength: 1
maxLength: 60
maxItems: 20
default: []
event_type:
type: string
maxLength: 40
tags:
type: array
items:
type: string
maxLength: 60
maxItems: 20
start_time:
type: string
maxLength: 8
end_time:
type: string
maxLength: 8
is_free:
type: boolean
price_note:
type: string
maxLength: 200
url:
anyOf:
- type: string
format: uri
- type: string
enum:
- ''
description:
type: string
maxLength: 5000
join_url:
type: string
maxLength: 500
join_meeting_id:
type: string
maxLength: 40
join_passcode:
type: string
maxLength: 40
join_phone:
type: string
maxLength: 40
contact_name:
type: string
maxLength: 120
contact_email:
type: string
maxLength: 200
organizer_email:
type: string
website:
type: string
turnstileToken:
type: string
required:
- title
- start_date
responses:
'201':
description: 201 response
content:
application/json:
schema:
type: object
properties:
id:
type: string
message:
type: string
required:
- id
- message
'400':
description: 400 response
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: 403 response
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'503':
description: 503 response
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
operationId: postApiSubmissions
x-operation-id-source: derived
components:
schemas:
ApiError:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
details: {}
required:
- code
- message
required:
- error
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'API key from /admin/api-keys: Authorization: Bearer cef_<scope>_...'
cookieAuth:
type: apiKey
in: cookie
name: cef_session